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内 容 简 介 


本 书 介绍 了 比较 流行 的 技术 Struts 2， 全 书 分 为 4 篇， 分别 为 ; Stmts 2 基础 篇 、Stmts 2 知识 篇 、Struts 2 
应 用 篇 和 实例 篇 。Struts 2 基础 篇 (第 1 一 2 章 ) 讲 解 了 Struts 2 的 基础 配置 。Struts 2 知识 篇 (第 3 一 10 章 ) 讲 解 了 
Struts 2 的 各 种 知识 ， 如 : 数据 类 型 转换 、 国 际 化 、 异 常 处 理 、 拦 截 器 、 数 据 校 验 、OGNL、 标 签 库 、 文 件 上 
传 下 载 和 避免 表单 重复 提交 等 。Struts 2 应 用 篇 (第 11 一 13 章 ) 讲 解 了 Stmts 2 与 Hibernate 的 整合 开发 , Strmuts 2、 
Hibernate 和 Spring 的 整合 开发 ， 以 及 Stmts 2 与 下 reeChart 的 整合 ， 还 有 Struts 2 和 Ajax 的 结合 应 用 。 最 后 实 
例 篇 (第 14 一 15 章 ) 通 过 太极 研修 院 企业 网 站 和 人 力 资源 管理 系统 两 个 综合 实例 帮助 读者 全 面 掌握 在 实际 项 目 
中 使 用 Struts 2 技术 ， 提 高 对 大 型 应 用 系统 的 整体 把 握 ， 使 读者 熟练 掌握 Struts 2 技术 。 

本 书 适合 具有 一 定 Web 开发 经 验 的 开发 人 员 ， 或 具有 其 他 Web 框架 使 用 经 验 的 开发 人 员 或 想 要 学 习 
Struts 2 开发 的 开发 人 员 ， 以 及 正在 从 事 Java Web 开发 的 开发 人 员 。 
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前 言 


对 于 Struts 1 框架 而 言 ， 由 于 与 JSP/Servlet 耦合 非常 紧密 ， 因 而 导致 了 一 些 严重 的 问题 。 
首先 ，Struts 1 支持 的 表现 层 技术 单一 。 由 于 Stmts 1 出 现 的 年 代 比 较 早 ， 那 个 时 候 没 有 
FreeMarker、Velocity 等 技术 ,因此 它 不 可 能 与 这 些 视 图 层 的 模板 技术 进行 整合 。 其 次 ，Struts 1 
与 Servlet API 的 严重 耦合 ， 使 应 用 难于 测试 。 最 后 ，Struts 1 代码 严重 依赖 于 Struts 1 API， 属 
于 侵入 性 框架 。 

Struts 2 的 体系 与 Struts 1 体系 的 差别 非常 大 ， 因 为 Struts 2 使 用 了 WebWork 的 设计 核心 ， 
而 不 是 Struts 1 的 设计 核心 Struts 2.0 其 实 就 是 WebWork 2.3, 如 果 读 者 使 用 过 WebWork 框架 ， 
那么 学 习 Stmts 2 就 能 很 快 上 手 。Struts 2 中 大 量 使 用 拦截 器 来 处 理 用 户 的 请 求 ， 从 而 允许 用 户 
的 业务 逻辑 控制 器 与 Servlet API 分 离 。 相 信 随 着 时 间 的 推移 , Struts 2 还 将 续 写 Struts 1 的 辉煌 。 
因此 ， 我 们 现在 学 习 Struts 2， 可 以 提高 我 们 的 竞争 力 。 


1. 本 书 内 容 


第 1 章 Struts 2 扬帆 起 航 。 本 章 首先 介绍 了 Struts 2 的 优点 和 框架 架构 ， 然 后 讲解 了 
Struts 2 的 配置 文件 ， 最 后 介绍 了 Struts 2 的 标签 库 和 控制 器 组 件 。 

第 2 章 完美 的 Struts 2 配置 。 本 章 首先 向 读者 讲解 了 Struts 2 的 基本 配置 如 : web.xml、 
struts.xml、struts.properties、struts-default.xml 等 ， 然 后 详细 介绍 了 Struts 2 的 深入 配置 ， 接 下 
来 讲解 了 Action 配置 、Result 的 配置 、Result 的 动态 配置 ， 最 后 介绍 了 Struts 2 异常 机 制 的 
应 用 。 

第 3 章 ”数据 类 型 大 转换 。 本 章 首先 介绍 了 类 型 转换 的 作用 、 如 何 使 用 类 型 转换 器 ， 以 及 
Stmts 2 对 null 属性 的 处 理 ， 然 后 讲解 了 Struts 2 的 类 型 转换 对 List、Map 和 Set 的 支持 ， 最 后 
讲解 了 使 用 注解 来 配置 类 型 转换 。 

第 4 章 国际 化 与 异常 处 理 。 本 章 首 先 介绍 了 Java 国际 化 的 思路 和 Struts 2 中 的 全 局 国际 
化 资源 文件 ， 以 及 输出 国际 化 消息 , 然后 讲解 了 使 用 Action 范围 的 国际 化 和 使 用 <s:il8n/> 标 签 
实现 国际 化 ， 最 后 讲解 了 使 用 Struts 2 实现 国际 化 。 

第 5 章 Stmts 2 中 的 拦路 虎 一 一 拦截 器 。 本 章 首先 介绍 了 拦截 器 的 配置 ， 自 定义 拦截 器 
的 步骤 以 及 配置 ， 然 后 讲解 运用 方法 过 滤 拦 截 器 ， 并 讲解 了 Struts 2 的 内 置 拦截 器 ， 最 后 讲解 
了 拦截 器 注解 操作 ， 及 完成 权限 控制 拦截 器 。 

第 6 章 探索 数据 校 验 的 奥妙 本章 首 先 介 绍 了 在 Action 中 通过 编程 对 输入 数据 进行 验证 
及 validateXxxO0 和 validate(0 方 法 的 使 用 ， 然 后 介绍 了 Struts 2 内 置 的 验证 器 ， 以 及 验证 框架 在 
开发 中 的 使 用 ， 最 后 介绍 了 开发 自 定义 的 验证 器 和 验证 注解 的 使 用 。 

第 7 章 Stmts 2 中 完整 的 OGNL。 本 章 首先 讲解 了 OGNL 的 三 要 素 、OGNL 表达 式 的 使 
用 ， 然 后 讲解 了 OGNL 对 集合 的 操作 、lambda 表达 式 的 使 用 ， 最 后 讲解 了 Struts 2 对 OGNL 
表达 式 的 增强 。 

第 8 章 Stmts 2 的 标签 库 。 本 章 首先 介绍 了 Struts 2 的 控制 标签 和 数据 标签 的 使 用 ， 然 后 
讲解 了 模板 和 主题 的 应 用 以 及 表单 标签 的 使 用 ， 最 后 介绍 了 非 表 单 标签 的 使 用 。 
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第 9 章 ， 轻松 实现 文件 上 传 和 下 载 。 本 章 首先 介绍 了 如 何在 Struts 2 中 实现 文件 上 传 ， 然 
后 讲解 了 如 何 过 滤 文件 上 传 的 类 型 和 大 小 ， 最 后 讲解 了 如 何在 Struts 2 中 实现 文件 下 载 和 同时 
上 传 多 个 文件 的 步骤 。 

第 10 章 ”避免 表单 重复 提交 和 等 待 页 面 。 本 章 介 绍 了 防止 表单 重复 提交 的 机 制 、 
TokenIntercepter 拦截 器 的 使 用 、TokenSessionStoreInterceptor 拦截 器 的 使 用 以 及 使 用 
ExecuteAndWaitInterceptor 拦截 器 向 用 户 显 示 等 待 页 面 。 

第 11 章 黄金 搭档 Stmuts 2 集成 Spring 与 Hibermate。 本 章 首先 介绍 了 Hibernate 的 作 
用 以 及 Hibernate 的 开发 应 用 , 然后 介绍 了 Spring 的 作用 , 最 后 详细 讲解 了 Struts 2 和 Hibernate 
的 集成 开发 以 及 Struts 2、Hibernate 和 Spring 的 集成 开发 。 

第 12 章 整合 下 reeChart。 本 章 首先 介绍 了 JFreeChart 生成 饼 图 、 柱 状 图 以 及 折线 图 ， 然 
后 讲解 了 JEFreeChart 生成 时 间 顺 序 图 和 带 交 互 功 能 的 热点 统计 图 ， 最 后 详细 讲解 了 Struts 2 与 
JEFreeChart 的 整合 。 

第 13 章 当 Stmts 2 碰见 Ajax。 本 章 首 先 介绍 了 Ajax 的 输入 校 验 ， 然 后 介绍 了 DWR 框 
架 的 使 用 和 JSON 串 作为 数据 的 载体 ， 最 后 讲解 了 Doie 框架 的 使 用 和 Struts 2 的 Ajax 标签 。 

第 14 章 太极 研修 院 企业 网 站 。 本 章 使 用 Struts 2 和 Hibernate 3 技术 开发 了 一 个 太极 研 
修 院 企 业 网 站 ， 实 现 的 前 台 功 能 包括 首页 展示 、 企 业 简 介 、 新 闻 中 心 、 太 极 商 城 、 在 线 视 频 、 
太极 风采 和 培训 招生 等 ， 其 后 台 功 能 包括 新 闻 中 心 、 太 极 商 城 、 信 息 管理 、 用 户 管理 、 日 志 管 
理 和 系统 信息 等 。 

第 15 章 人 力 资源 管理 系统 。 本 章 整 体 采 用 了 Struts 2、Hibernate 和 Spring 三 大 框架 实现 
了 一 个 人 力 资源 管理 系统 。 本 系统 具有 员工 管理 、 招 聘 管 理 、 奖 惩 管理 、 培 训 管理 、 薪 资 管理 
及 管理 员 模块 。 

2. 本 书 特色 

本 书 中 大 量 内 容 来 自 真实 的 Struts 2 项 目 ， 力 求 通过 读者 实际 操作 中 采取 的 解决 问题 的 方 
法 使 读者 更 容易 地 掌握 Struts 2 的 应 用 开发 。 本 书 难度 适中 ， 内 容 由 浅 入 深 ， 实 用 性 强 ， 覆 羡 
面 广 ， 条 理 清 晰 。 

1) ”结构 独特 

» 通过 “网 络 教学 、 基 础 知识 、 实 例 描述 、 实 例 应 用 、 运 行 结 果 、 实 例 分 析 ” 的 形式 ， 将 每 
个 知识 与 实际 应 用 中 的 问题 相 结合 。 

2) ”形式 新 颖 

本 书 用 准确 的 语言 总 结 概念 ， 用 直观 的 图 示 演 示 过 程 ， 用 详细 的 注释 解释 代码 ， 用 形象 的 
比喻 帮助 记忆 。 

3) ”技术 文档 

将 一 些 非常 简单 的 知识 点 或 者 理论 性 的 内 容 穿插 其 中 ， 通 常 这 些 文档 没有 具体 的 实践 操 
作 ， 但 是 读者 又 必须 要 了 解 的 ， 像 一 些 概念 和 术语 。 

4) 内容 丰 富 

涵盖 了 实际 开发 中 Struts 2 技术 所 遇 到 的 Hibemate、Spring、JFreeChart 和 Ajax 等 方面 的 
热点 问题 。 
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5) ” 随 书 光盘 

本 书 为 实例 配备 了 视频 教学 文件 ， 读 者 可 以 通过 视频 文件 更 加 直观 地 学 习 Struts 2 的 使 用 
知识 。 

6) ”网 站 支持 

读者 在 学 习 或 者 工作 的 过 程 中 ， 如 果 遇 到 实际 问题 ， 可 以 直接 登录 www.itzcn.com 与 我 们 
取得 联系 ， 我 们 会 在 第 一 时 间 内 给 予 帮助 。 

7) 贴心 提示 

为 了 便于 读者 阅读 ， 全 书 还 穿插 了 一 些 技巧 、 提 示 等 小 贴 士 ， 体 例 约定 如 下 。 

提示 : 通常 是 一 些 贴心 的 提醒 ， 让 读者 加 深 印 象 或 为 读者 提供 建议 , 或 者 为 读者 提供 解决 
问题 的 方法 。 

注意 : 提出 学 习 过 程 中 需要 特别 注意 的 一 些 知识 点 和 内 容 ， 或 者 相关 信息 。 

技巧 : 通过 简短 的 文字 ， 指 出 在 应 用 知识 点 时 的 一 些小 窍门 。 

3. 读者 对 象 

本 书 具 有 知识 全 面 、 实 例 精彩 、 指 导 性 强 的 特点 ， 力 求 以 知识 的 全 面 性 及 丰富 的 实例 来 指 
导读 者 透彻 地 学 习 Struts 2 各 方面 的 知识 。 本 书 可 以 作为 Struts 2 的 入 门 书籍 , 也 可 以 帮助 中 级 
读者 提高 技能 ， 对 高 级 读者 也 有 一 定 的 启发 意义 。 

本 书 适合 以 下 人 员 阅 读 学 习 。 

@ 具有 一 定 Web 开发 经 验 的 开发 人 员 

@ 具有 其 他 Web 框架 使 用 经 验 的 开发 人 员 

@ ” 想 要 学 习 Strmts 2 开发 的 开发 人 员 

@ 正在 从 事 Java Web 开发 的 开发 人 员 

4. 参 编 人 员 


本 书 主要 由 杨 少 敏 、 攀 双 灵 编写 , 其 他 参与 编写 、 资料 整理 、 程 序 开 发 的 人 员 还 有 杨 伟 康 、 
岳 培 园 、 翟 珊 珊 、 张 冬 旭 、 赵 振 方 、 郑 小 营 、 赵 俊昌 、 段 韵 治 、 胡 海 静 等 。 
由 于 编者 水 平 有 限 ， 书 中 难免 存在 不 足 和 疏漏 之 处 ， 屋 请 读者 批评 指正 。 
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第 1 章 Struts 2 扬帆 起 航 


内 容 摘 要 : 
Stmts 只 是 一 个 MVC 框架 (Framework)， 用 于 快速 开发 Java Web 应 用 。Struts 实现 的 重点 
在 C(Controller)， 包 括 ActionServlet/RequestProcessor 和 我 们 定制 的 Action， 也 为 V(View) 提 供 
了 一 系列 定制 标签 (Custom Tag)。 但 Struts 几乎 没有 涉及 M(Model)， 所 以 Struts 可 以 采用 Java 
实现 的 任何 形式 的 商业 逻辑 。 
Struts 最 早 是 作为 Apache Jakarta 项 目的 组 成 部 分 问世 运作 。 项 目的 创立 者 希望 通过 对 该 项 
目的 研究 ， 改 进 和 提高 Java Server Pages、Servlet、 标 签 库 ， 提 高 面向 对 象 的 技术 水 准 。 
Struts 这 个 名 字 来 源 于 在 建筑 和 旧式 飞机 中 使 用 的 支持 金属 架 。 它 的 目的 是 减少 在 运用 
MVC 设计 模型 来 开发 Web 应 用 的 时 间 。 
Strmts 跟 Tomcat、Turbine 等 诸多 Apache 项 目 一 样 ， 是 开源 软件 ， 这 是 它 的 一 大 优点 ， 同 
时 可 以 使 开发 者 能 更 深入 地 了 解 其 内 部 实现 机 制 。 
除 此 之 外 ，Struts 的 优点 主要 集中 体现 在 两 个 方面 : Taglib 和 页 面 导航 。Taglib 是 Struts 
的 标记 库 ， 灵活 动用， 能 大 大 提高 开发 效率 . 另外， 就 目前 国内 的 JSP 开发 者 而 言 ， 除 了 使 用 
JSP 自 带 的 常用 标记 外 ， 很 少 开发 自己 的 标记 ， 或 许 Struts 是 一 个 很 好 的 起 点 。 
学 习 目 标 : 
@@ 了 解 Struts 的 优点 。 
理解 Struts 2 的 框架 架构 。 
熟悉 Struts 2 的 配置 文件 。 
掌握 Struts 2 的 标签 
池 提 stm 
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1.1 Struts 2 发 展 史 


Stmts 2 以 WebWork 优秀 的 设计 思想 为 核心 ， 继 承 了 Struts 1 的 部 分 优点 ， 建 立 了 一 个 兼 
容 WebWork 和 Stmts 1 的 MVC 框架 .Struts 2 的 目标 就 是 希望 可 以 和 原来 的 Struts 1 .WebWork 
的 开发 人 员 都 可 以 平稳 熟练 地 使 用 Struts 2 的 框架 。 


A9 
上 视频 教学 : 光盘 /videos/01/ Struts 2 _jianjie.avi @@ 长 度 : 7 分 钟 


1.1.1 Struts 2 的 简介 


Struts 2 是 Struts 1 的 下 一 代 产 品 。 它 在 Struts 1 和 WebWork 的 技术 基础 上 进行 了 合并 , 是 
一 种 全 新 的 框架 。Struts 2 的 体系 结构 与 Struts 1 有 着 巨大 的 差别 。 Struts 2 以 WebWork 为 核心 ， 
采用 拦截 器 的 机 制 来 处 理 用 户 的 请 求 ， 这 使 得 业务 逻辑 控制 器 能 够 与 Servlet API 完全 脱离 开 ， 
所 以 Stmuts 2 可 以 理解 为 WebWork 的 更 新 产品 。Struts 2 和 Struts 1 有 着 非常 大 的 变化 , 但 是 相 
对 于 WebWork，Stmts 2 只 有 很 小 的 变化 。 

Apache Struts 2 就 是 大 家 所 熟知 的 WebWork 2。 它 是 一 个 优雅 的 、 可 扩展 的 JAVA EE Web 
框架 。 框 架设 计 的 目标 贯穿 于 整个 开发 周期 ， 从 开发 到 发 布 ， 包 括 维护 的 整个 过 程 。 

在 经 历 了 几 年 的 各 自发 展 后 ，WebWork 和 Struts 社区 决定 合 二 为 一 ， 也 即 是 Struts 2。 


1.1.2 Struts 2 和 Struts 1 的 不 同 


Struts 2 与 Struts 1 已 经 不 能 再 放 到 一 起 比较 ， 虽 然 都 是 对 MVC 架构 模式 的 实现 ， 本 质 却 
完全 不 同 。Struts 2 的 前 身 是 WebWork， 其 实现 方式 和 功能 都 要 优 于 Struts 1， 但 是 ，Struts 1 
先入 为 主 ， 很 多 应 用 程序 都 基于 Struts 1， 其 生命 力 和 普及 度 使 得 WebWork 落 于 下 风 。 随 着 新 
思想 和 新 架构 的 不 断 涌 入 ,特别 是 Web 2.0 被 大 量 提 及 , Struts 1 显然 无 法 跟 上 日 新 月 异 的 变化 ， 
在 很 多 应 用 上 显得 力不从心 ， 最 终 催生 了 Struts 2。 可 以 说 Struts 2 是 为 变 而 变 。 


1. Action 类 
@ Stmts 1 要 求 Action 类 继承 于 一 个 抽象 基 类 。Struts 1 的 一 个 普遍 问题 是 使 用 抽象 类 编 
程 而 不 是 接口 。 


@ Strmts 2 的 Action 类 可 以 实现 一 个 Action 接口 ， 也 可 实现 其 他 接口 ， 使 可 选 和 定制 的 
服务 成 为 可 能 。Struts 2 提供 一 个 ActionSupport 基 类 去 实现 常用 的 接口 。Action 接口 
不 是 必须 的 ， 任 何 有 execute 标识 的 POJO 对 象 都 可 以 作为 Struts 2 的 Action 对 象 。 


.线程 模式 


@ Stmts 1 Action 是 单 例 模式 并 且 必须 是 线程 安全 的 ， 因 为 仅 有 一 个 Action 实例 来 处 理 
所 有 的 请 求 。 单 例 策略 限制 了 Struts 1 Action 能 做 的 事 ， 并 且 要 在 开发 时 特别 小 心 。 
因此 Action 资源 必须 是 线程 安全 的 或 同步 的 。 


D 
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®@ Stmts 2 Action 对 象 为 每 一 个 请 求 产 生 一 个 实例 ， 因 此 没有 线程 安全 问题 。 实 际 上 ， 
Servlet 容器 给 每 个 请 求 产生 许多 可 丢弃 的 对 象 ， 并 且 不 会 导致 性 能 和 垃圾 回收 问题 。 

3. Servlet 依赖 

@ Stmts 1 Action 依赖 于 Servlet API, 因为 当 一 个 Action 被 调用 时 ,HttpServletRequest 和 
HttpServletResponse 被 传递 给 execute 方法 。 

@ Stmts 2 Action 不 依赖 于 容器 ， 人 允许 Action 脱离 容器 单独 被 测试 。 如 果 需 要 ，Struts 2 
Action 仍然 可 以 访问 初始 的 request 和 response。 但 是 ， 其 他 的 元 素 减少 或 者 消除 了 ， 
有 直接 访问 HttpServetRequest 和 HttpServletResponse 的 必要 性 。 

4. 可 测 性 

@ 测试 Struts 1 Action 的 一 个 主要 问题 是 execute 方 法 暴露 了 servlet API( 这 使 得 测试 要 依 
赖 于 容器 )。 一 个 第 三 方 扩 展 一 一 Stmruts TestCase 提供 了 一 套 Struts 1 的 模拟 对 象 (来 进 
行 测试 )。 

@ Stmts 2 Action 可 以 通过 初始 化 、 设 置 属性 、 调 用 方法 来 测试 ， “依赖 注入 ”支持 使 
测试 更 加 容易 。 

5. 表达 式 语言 

@ Stmts 1 整合 了 JSTL， 因 此 使 用 JSTL EL。 这 种 EL 有 基本 对 象 图 遍历 ， 但 是 对 集合 
和 索引 属性 的 支持 很 弱 。 

@ Stmts 2 可 以 使 用 JSTL， 它 更 支持 一 个 更 强大 和 灵活 的 表达 式 语言 一 一 Object-Graph 
Navigation Language(OGNL 对 象 图 导航 语言 )。 

@ ”Struts 1 使 用 标准 JSP 机 制 把 对 象 绑 定 到 页 面 中 来 访问 。 

@ Stmts 2 使 用 ValueStack 技术 ， 使 taglib 能 够 访问 值 而 不 需要 把 页 面 (view) 和 对 象 绑 定 
起 来 。ValueStack 策略 允许 通过 一 系列 名 称 相同 但 类 型 不 同 的 属性 重用 页 面 (view)。 

6. 类 型 转换 

@ Stmts 1 ActionForm 属性 通常 都 是 String 类 型 。Struts 1 使 用 Commons-Beanutils 进行 
类 型 转换 。 每 个 类 一 个 转换 器 ， 对 每 一 个 实例 来 说 是 不 可 配置 的 。 

@ Stmts 2 使 用 OGNL 进行 类 型 转换 。 由 他 (OGNL) 提 供 基 本 和 常用 对 象 的 转换 器 。 

7. 校 验 

@ Strmts 1 支持 在 ActionForm 的 validate0 方 法 中 手动 校 验 , 或 者 通过 Commons Validator 
的 扩展 来 校 验 。 同 一 个 类 可 以 有 不 同 的 校 验 内 容 ， 但 不 能 校 验 子 对 象 。 

@ ”Stmts 2 支持 通过 validate0 方 法 和 XWork 校 验 框架 来 进行 校 验 ,XWork 校 验 框架 使 用 
为 属性 类 类 型 定义 的 校 验 和 内 容 校 验 ， 来 支持 chain 校 验 子 属性 。 

8. Action 执行 的 控制 

@ Stmts 1 支持 每 一 个 模块 ， 有 单独 的 Request Processors( 生 命 周期 )， 但 是 模块 中 的 所 有 


Action 必须 共享 相同 的 生命 周期 。 


<@— 
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@ Stmts 2 支持 通过 拦截 器 堆栈 (Interceptor Stacks) 为 每 一 个 Action 创建 不 同 的 生命 周期 。 
堆栈 能 够 根据 需要 和 不 同 的 Action 一 起 使 用 。 


1.2 Struts 2 体系 介绍 


对 于 学 过 Struts 1 体系 的 人 来 说 ， 在 下 面 的 学 习 中 会 感觉 Struts 1 和 Struts 2 的 体系 差别 非 
常 大 ， 因 为 Struts 2 使 用 了 WebWork 的 设计 核心 ， 而 不 是 使 用 了 Struts 1 的 设计 核心 。Struts 2 
使 用 大 量 的 拦截 器 来 处 理 用 户 的 请 求 ， 允 许 用 户 的 业务 逻辑 控制 器 来 与 Servlet API 分 离 。 


1.2.1 基础 知识 


一 个 请 求 在 Struts 2 框架 中 的 处 理 大 概 分 为 以 下 几 个 步骤 。 

(1) 客户 端 提交 一 个 HttpServletRequest 请 求 ， 例 如 在 浏览 器 中 输入 http://localhost: 
8080/Struts2/chl/Reg.action 就 是 提交 一 个 HttpServletRequest 请 求 。 

(2) 请 求 被 提交 到 一 系列 (主要 是 3 层 ) 的 过 滤器 (Filter), 如 ActionContextCleanUp SiteMesh 
和 FilterDispatcher 等 。 


注意 这 里 是 有 顺序 的 ， 首 先是 提交 ActionContextCleanUp， 再 到 其 他 过 滤器 (Othter 
注意 Filters、SiteMesh 等 )， 最 后 到 FilterDispatcher。 


(3) FilterDispatcher 是 控制 器 的 核心 ， 就 是 MVC 的 Stmuts 2 实现 中 控制 层 的 核心 。 
FilterDispatcher 询问 ActionMapper 是 否 需要 调用 某 个 Action 来 处 理 这 个 请 求 ， 如 果 
ActionMapper 决定 需要 调用 某 个 Action，FilterDispatcher 则 把 请 求 的 处 理 交 给 ActionProxy。 

(4) ActionProxy 通过 Configuration Manager(struts.xml) 询 问 框 架 的 配置 文件 ， 找 到 需要 调 
用 的 Action 类 。 例如 , 用 户 注 册 示 例 将 找到 UserReg 类 。ActionProxy 创建 一 个 ActionInvocation 
实例 ， 同 时 ActionInvocation 通过 代理 模式 调用 Action。 但 在 调用 之 前 ，ActionInvocation 会 根 
据 配 置 加 载 Action 相关 的 所 有 Interceptor( 拦 截 器 )。 一 旦 Action 执行 完毕 ，ActionInvocation 负 

) 责 根据 struts.xml 中 的 配置 找到 对 应 的 返回 结果 result。 图 1-1 是 Struts 流程 图 。 


构 流 流程 


1.2.2 ”基础 知识 


Stmts 2 共有 5 类 配置 文件 , 分 别 是 struts.xml、struts.properties、Web.xml、struts-plugin.xml 
和 struts_defaultxml。 本 节 将 详细 向 大 家 讲解 这 些 配置 文件 的 相关 知识 。 


1. struts.xml 文件 


struts.xml 定义 应 用 自身 使 用 的 action 映射 及 result， 但 我 们 一 般 将 应 用 的 各 个 模块 分 到 不 
同 的 配置 文件 中 。 


Eee >> 
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HupServietResponse 
User Created 


图 1-1 Struts 流程 图 


首先 必须 在 struts.xml 文件 的 对 应 程序 做 相应 的 配置 ， 其 中 需要 对 每 个 动作 进行 相应 拦截 
器 的 调用 ， 对 每 种 动作 的 运行 结果 进行 配置 等 。 在 拦截 器 中 ， 必 须 在 使 用 前 进行 注册 ，Struts 
配置 文件 可 以 支持 继承 ， 默 认 的 配置 文件 包 在 Struts 2-core-VERSION.jar 中 。struts-default.xml 
文件 是 那些 默认 配置 文件 之 一 。 它 的 主要 功能 就 是 用 来 注册 默认 的 结果 类 型 和 拦截 器 。 所 以 ， 
在 使 用 的 时 候 没 必 要 在 struts.xml 文件 里 进行 注册 ， 就 可 以 使 用 默认 的 结果 类 型 和 拦截 器 。 
struts.xml 文件 代码 如 下 所 示 。 
<!-- 省 略 部 分 代码 --> 
<?xml Version="1.0"” encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.il8n.encoding" value="gbk" /> 
<include file ="struts-default.xml" /> 
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<!-- 省 略 部 分 代码 --> 

在 struts 节点 下 有 很 多 的 子 节点 ， 而 这 些 子 节点 则 是 配置 框架 的 主要 因素 。 接 下 来 讲解 
struts 节点 下 的 子 节点 的 含义 。 


<@—— 
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1) include 元 素 

在 strut.xml 中 我 们 会 经 常 发 现 include 元 素 。 一 个 大 的 应 用 程序 可 能 有 许多 的 包 ， 为 了 使 
strut.xml 便于 管理 ， 我 们 可 以 把 它 拆 分 成 几 个 小 的 配置 文件 ， 然 后 再 使 用 include 元 素来 应 用 
这 些 拆 分 的 配置 文件 。 

2) ”package 元 素 

为 了 方便 使 用 ，Struts 可 以 把 各 种 动作 分 门 别 类 地 组 织 成 不 同 的 包 ， 即 package。 在 此 可 以 
把 它 当 作 struts.xml 文件 典型 的 模板 。 详 细 代码 如 下 所 示 。 

<!-- 省 略 部 分 代码 --> 

<package name="userinfo" namespace="/userinfo" extends="struts-default"> 


<global-results> 
<result name="error">/exception.jsp</result> 


</global-results> 
<global-exception-mappings> 
<exception-mapping result="error™" 
exception="java.lang.RuntimeException"> 
</exception-mapping> 
</global-exception-mappings> 
<action name="loginuser" class="com.itzcn.action.Userinfo"> 
<result name="loginout">/loginout.jsp</result> 
</action> 
</package> 
<!-- 省 略 部 分 代码 --> 
在 上 述 配 置 文件 中 ，package 可 以 有 一 个 或 多 个 ， 每 个 package 都 必须 有 一 个 不 同 的 name 
属性 。 其 中 namespace 属性 是 可 有 可 无 的 属性 ， 如 果 没有 设置 该 属性 则 默认 是 “/”， 如 果 设 置 
了 该 属性 的 值 ， 那 么 在 使 用 这 个 包 里 而 的 动作 时 ， 就 必须 把 该 属性 的 命名 空间 添加 到 有 关 的 
URI 字符 器 中 。global 节点 是 用 来 捕获 异常 的 ， 在 设置 了 java.ang.RuntimeException 后 运行 出 
现 异 常 ， 这 样 捕捉 到 异常 之 后 转向 指定 的 error 页 面 。 
3) ”constant 元 素 
如 果 不 需 要 创建 一 个 新 的 文件 ， 那 么 可 以 在 struts.xml 文件 里 使 用 constant 元 素 。 详 细 代 
码 如 下 所 示 。 
<!-- 省 略 部 分 代码 --> 
<?xml version="1.0" encoding="UTF-8" ?> 


<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 


"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<constant name="struts.il8n.encoding" value="gbk" /> 
<constant name="struts.devMode" value="true" /> 
</struts> 
<!-- 省 略 部 分 代码 --> 
其 中 struts.xml 文 件 主要 负责 管理 应 用 中 的 Action 映射 以 及 该 Action 包含 的 Result 定 义 等 。 
除 此 之 外 ，Strut 2 框架 还 包含 了 一 个 struts.properties 文件 ， 该 文件 定义 了 Struts 2 框架 的 大 量 
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属性 ， 可 以 通过 修改 这 些 属性 来 满足 我 们 的 需求 。 

2. struts.properties 文件 

struts.properties 用 来 定义 框架 自身 的 全 局 变量 ， 该 文件 定义 的 全 局 属性 也 可 以 在 struts.xml 
中 定义 。 

struts.properties 文件 是 一 个 标准 的 Properties 文件 , 该 文件 包含 了 一 系列 的 key-value 对 象 ， 
每 个 key 就 有 一 个 Struts 2 属性 ， 该 key 对 应 的 value 就 是 一 个 Struts 2 属性 值 。 该 文件 通常 放 
在 Web 应 用 的 WEB-INF/classes 路 径 下 。 将 该 文件 放 入 Web 应 用 程序 下 的 CLASSPATH 路 径 
下 ，Struts 2 框架 就 可 以 加 载 该 文件 。 

3. Web .xml 文件 

准确 地 说 , Web.xml 不 属于 Struts 2 框架 特有 的 文件 。 作 为 部 署 文 件 Web.xml 是 所 有 Java 
Web 项 目的 核心 文件 。 然 而 在 这 里 之 所 以 讲 到 该 配置 文件 ， 是 因为 在 使 用 Struts 2 框架 时 ， 需 
要 在 Web.xml 中 配置 一 个 前 段 控制 器 FilterDispatcher， 用 于 对 Struts 2 框架 进行 初始 化 和 处 理 
所 有 的 请 求 。 详 细 代码 如 下 所 示 。 
<!-- 省 略 部 分 代码 --> 


<?xml version="1.0" encoding="UTF-8"?> 


<Web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/Web-app 2 5.xsd"> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
<filter> 
<filter-name>struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping></Web-app> 
<!-- 省 略 部 分 代码 --> 


4. struts-plugin.xml 文件 

struts-plugin.xml 文件 是 struts 插件 使 用 的 配置 文件 ， 例 如 当 结 合 struts 和 spring 一 起 使 用 
时 就 需要 在 Web.xml 中 引用 该 配置 文件 ， 这 里 不 再 详细 说 明 。 

5. struts-default.xml 文件 


struts-default.xml 用 来 定义 框架 自身 使 用 的 action 映射 及 result 定义 ， 是 struts 2 框架 默认 
加 载 的 配置 文件 。 它 定义 了 struts 2 的 一 些 核心 bean 和 拦截 器 。struts-default 包 就 是 在 struts- 
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defaultxml 文件 中 定义 的 。 该 文件 中 还 可 以 定义 Struts 2 内 置 的 结果 类 型 、 内 置 的 拦截 器 以 及 
不 同 拦截 器 组 成 的 拦截 器 栈 , 这 些 拦截 器 栈 可 以 直接 使 用 。 在 strut-default.xml 文件 的 最 后 还 可 
以 定义 默认 的 拦截 器 引用 。 


0 5》 如 果 让 Struts 2 不 加 载 struts-default.xml， 或 者 加 载 自 定义 的 配置 文件 ， 可 以 在 
提示 struts.properties 文件 中 设置 struts.configuration.files 属性 。 


1.2.3 ”基础 知识 


Struts 2 的 控制 器 组 件 


Struts 2 的 控制 器 组 件 是 Struts 2 框架 的 核心 ， 事 实 上 ， 所 有 MVC 框架 都 是 以 控制 器 组 件 
为 核心 的 。Struts 2 的 控制 器 由 两 部 分 组 成 : FilterDispatcher 和 业务 控制 器 Action。 

Stmts 2 应 用 中 起 作用 的 业务 控制 器 不 是 用 户 定义 的 Action, 而 是 系统 生成 的 Action 代理 ， 
但 该 Action 代理 是 以 用 户 定义 的 Action 为 目标 的 。 详 细 代码 如 下 所 示 。 


<!-- 省 略 部 分 代码 --> 
import com.opensymphony.xwork2.ActionSupport; 
public class Userinfo extends ActionSupport{ 
private String username; 
public String getUsername() { 
return username; 
} 


public void setUsername (String username) { 


this.username = username; 

} 

Public String login(){ 
String num=""; 
if(username.equals ("admin")) 
{ 

num="loginout"; 
F 
return num; 
1 
} 
<!-- 省 略 部 分 代码 --> 


通过 查看 上 面 的 Action 代码 ， 发 现 该 Action 比 WebWork 中 的 Action 更 彻底 。 该 Action 
无 需 实现 任何 父 接口 ， 无 需 继承 任何 Struts 2 基 类 ， 该 Action 类 完全 是 一 个 POJO( 普 通 、 传 统 
的 Java 对 象 )， 因 此 具有 很 好 的 复 用 性 。 


1.2.4 实例 描述 
以 上 的 讲解 只 是 大 致使 读者 了 解 了 Struts 2 的 基本 应 用 原理 ， 接 下 来 将 使 用 一 个 简单 的 会 


员 登 录 系 统 来 检验 一 下 对 Struts 2 的 掌握 情况 。 通 过 Struts 2 的 配置 文件 对 系统 进行 配置 , 获取 
用 户 输入 的 用 户 名 和 密码 ， 然 后 判断 用 户 是 否 登 录 成 功 ! 
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1.2.5 ”实例 应 用 


【 例 1-1】 Struts 2 体系 介绍 。 
在 开始 制作 项 目 之 前 ， 首 先 需 要 将 开发 环境 搭建 好 。 本 章 主要 讲解 开发 环境 和 运行 环境 的 
搭建 。 表 1-1 所 示 是 搭建 开发 环境 所 需要 的 软件 ， 下 载 后 进行 安装 ， 配 置 环境 。 
表 1-1 环境 配置 软件 


软 件 下 载 地 址 
JDK http://java.sun.com 
Tomcat http://tomcat.apache.org 
MyEclipse http://downloads.myeclipseide.com/ 


首先 在 MyEclipse 开发 工具 中 ， 创 建 一 个 名 为 News 的 Web 项 目 ， 然 后 进行 环境 搭建 。 
1. 硬件 环境 

处 理 器 : Intel Pentium。 

内 存 : 32M 或 以 上 。 

硬盘 空间 : 1GB 以 上 。 
软件 环境 


操作 系统 : Windows 2003 /2000/XP 。 
Web 服务 器 : Tomcat 6.0 或 以 上 版 本 。 
开发 工具 : MyEclipse。 

客户 端 : IE 5.0 或 以 上 版 本 。 

开发 语言 : JSP、Java。 

3. 配置 环境 


首先 将 JAR 包 导 入 工程 的 lib 目录 下 ， 
logging-1.0.4.jar、 freemarker-2.3.15.jar、 ognl-2.7.3.jar、 Struts 2-core-2.1.8.1.jar、 xwork-core-2.1.6.jar 
六 个 JAR 包 。 

1) “定义 struts.xml 文件 

接 下 来 在 src 目录 下 创建 一 个 struts.xml 配置 文件 ， 代 码 如 下 所 示 。 

<!-- 省 略 部 分 代码 --> 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 


"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 


eeeenhNh eese 


导入 commons-fileupload-1.2.1.jar、commons- 


<constant name="struts.il8n.encoding" value="gbk" /> 
<include file ="struts-default.xml" /> 
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<package name="userinfo" namespace="/" extends="struts-default"> 


<global-results> 
<result name="error">/error.html</result> 
</global-results> 
<global-exception-mappings> 
<exception-mapping result="error" 
exception="java.lang.RuntimeException"> 
</exception-mapping> 
</global-exception-mappings> 
<action name="loginuser" class="com.itzcn.action.Userinfo"> 
<result name="loginout">/loginout.jsp</result> 
<result name="index">/index.jsp</result> 
</action> 


</package> 
</struts> 
<!-- 省 略 部 分 代码 --> 
在 上 述 配 置 文件 中 ， 通 过 配置 constant 节点 进行 编码 格式 。 在 struts.xml 文件 中 ， 配 置 运 
行 时 异常 处 理 的 页 面 请 求 。 在 该 配置 文件 中 ， 最 重要 的 是 action 的 配置 ， 在 此 指定 action 的 业 


务 类 地 址 和 请 求 转发 的 页 面 。 


配置 Web.xml 文件 
配置 好 struts.xml 文件 后 则 是 配置 Web.xml 文件 。 在 Web.xml 文件 中 配置 一 个 前 端 控制 器 


FilterDispatcher， 用 于 对 Struts 框架 的 初始 化 和 处 理 所 有 的 请 求 。 详 细 代 码 如 下 所 示 。 


<!-- 省 略 部 分 代码 --> 

<?xml version="1.0"” encoding="UTF-8"?> 

<Web-apP version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance™ 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/Web-app 2_ 5.xsd"> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
“Tter 


<filter-name>struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping></Web-app> 
<!-- 省 略 部 分 代码 --> 


在 上 述 配置 文件 中 ， 主 要 配置 了 finter 节点 Struts 2 的 过 滤器 和 接受 请 求 的 方式 。 
3) ”编写 Action 类 
接 下 来 编写 业务 处 理 的 Action， 在 编写 Action 之 前 ， 首 先 要 明白 Action 的 主要 作用 ， 它 
主要 的 功能 是 对 用 户 提交 过 来 的 内 容 信息 作出 相应 的 回复 。Action 和 普通 的 类 一 样 ， 只 是 它 继 
承 了 一 个 ActionSupport 类 。 详 细 代 码 如 下 所 示 。 
<!-- 省 略 部 分 代码 --> 
public class Userinfo extends ActionSupport{ 
private String txtUsername; 
private String txtPass; 


public String getTxtUsername () { 
return txtUsername; 


于 
public void setTxtUsername (String txtUsername) { 
this .txtUsername = txtUsername; 
FE 
public String getTxtPass() { 
return txtPass; 
. 
public void setTxtPass(String txtPass) { 
this.txtPass = txtPass; 
public String logi() 
st 
String num="index"; 
if (txtUsername .equals ("admin") &g&txtPass.equals ("admin")) 
{ 
num="loginout"; 
: 
HttpServletRequest httprequest = ServletActionContext.getRequest (); 
httprequest .setAttribute ("ms", "登录 失败 ! 密码 错误 ! "); 
return num; 


} 
| 
<!-- 省 略 部 分 代码 --> 


在 上 述 代码 中 ， 定 义 了 两 个 成 员 变 量 和 它们 的 GETO 和 SETO 方 法 。 要 注意 的 是 该 变量 名 
称 必须 和 页 面 中 表单 提交 的 值 名 称 一 样 。 通 过 判断 返回 相应 的 页 而 ， 在 这 里 判断 用 户 名 和 密码 
是 否 等 于 “admin”。 


1.2.6 ”运行 结果 


通过 以 上 的 代码 编写 和 环境 搭建 配置 ， 接 下 来 将 是 显现 结果 的 时 刻 。 运 行 结果 如 图 1-2 
所 示 。 
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1.2.7 “实例 分 析 


es 


在 上 述 例 子 中 ， 主 要 学 习 的 内 容 就 是 Struts 2 框架 的 搭建 和 整合 。 在 搭建 该 框架 过 程 中 ， 
最 为 重要 的 是 它 的 配置 ， 其 中 struts.xml 文件 是 Struts 2 中 的 核心 配置 文件 ， 它 是 Struts 2 框架 
使 用 的 核心 组 件 。Bean 包含 的 静态 方法 需要 一 个 值 注入 。 它 可 以 在 不 创建 某 个 类 实例 的 情况 
下 接收 框架 常量 。 通 常 需要 设置 static=“true”。 当 指定 了 type 属性 时 ， 该 属性 不 应 该 指定 为 
Soe 


1.3 ” Struts 2 的 Hello World 


“Hello World” 程 序 指 的 是 只 在 计算 机 屏幕 上 输出 “Hello World!”。 一 般 来 说 ， 这 是 计 

算 机 编程 语言 中 最 基本 、 最 简单 的 程序 ， 也 通常 是 初学 者 编写 的 第 一 个 程序 。 通 过 这 个 程序 ， 

开发 者 可 以 确定 针对 该 语言 的 编 详 器 、 程 序 开发 环境 ， 以 及 运行 环境 是 否 安装 正确 。 在 此 也 可 
以 用 Stmuts 2 来 实现 一 个 “Hello World” 的 程序 。 


. 
Es 视频 教学 ， 光盘 /videos/01/ Struts2_develop.avi 人 @@ 长 度 : 8 分 钟 


1.3.1 基础 知识 


Struts 2 标签 库 提供 了 非常 丰富 的 功能 ， 因 此 Struts 2 标签 库 也 是 Struts 2 中 最 重要 的 一 部 
分 ， 这 些 标签 不 仅 提供 了 表示 层 的 数据 显示 处 理 ， 而 且 还 提供 了 基本 的 流程 控制 功能 ， 同 时 还 
支持 国际 化 和 Ajax 等 功能 。 

之 所 以 使 用 Struts 2 标签 ， 是 因为 这 些 标 签 可 以 为 开发 者 减少 大 量 的 代码 书写 ， 而 且 使 用 
也 非常 方便 。 
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在 JSP 页 面 中 引用 标签 库 ， 需 要 使 用 taglib 指令 。 该 指令 的 uri 属性 的 值 设置 为 <uri> 元 素 
的 内 容 ，prefix 属性 则 设置 为 该 标签 的 标题 ， 通 常设 置 为 “s”。 详 细 代码 如 下 所 示 。 


<%@ taglib prefix="s" uri="/struts-tags" $%> 


”Struts 2 标签 库 的 功能 非常 复杂 ,该 标签 库 可 以 完全 替代 JSTL 标签 库 , 而 且 Struts 
提示 2 的 标签 支持 表达 式 的 语言 。 


1.3.2 ”实例 描述 


该 实例 显现 的 是 : 通过 用 户 输入 不 同 用 户 的 名 称 ， 使 程序 输出 Hello World 字符 串 。 首 先 
创建 一 个 Web 项 目 ， 名 字 为 Hello World， 详 细 结构 如 图 1-3 所 示 。 然 后 ， 将 需要 导入 的 JAR 
包 导 入 工程 的 lib 目录 下 ， 通 过 用 户 在 页 面 中 输入 自己 的 用 户 名 ， 单 击 “ 确 定 ”按钮 进入 显示 
信息 页 面 。 


图 1-3 工程 结构 图 


1.3.3 ”实例 应 用 


【 例 1-2】 Struts 2 的 Hello World。 

创建 好 项 目 后 ， 需 要 做 的 第 二 步 则 是 将 项 目 搭建 上 Struts 2 的 运行 环境 ， 首 先 需要 配置 
struts.xml 文件 。 详 细 代码 如 下 所 示 。 

<!-- 省 略 部 分 代码 --> 


<?xml] Version="1.0"” encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.il8n.encoding" value="gbk" /> 
<include file ="struts-default.xml" /> 
<package name="test" namespace="/" extends="struts-default"> 
<global-results> 


<—— 
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<result name="error">/error.html</result> 
</global-results> 
<global-exception-mappings> 


<exception-mapping result="error" 
exception="java.lang.RuntimeException"> 

</exception-mapping> 

</global-exception-mappings> 

<action name="helloworld" class="com.itzcn.action.HelloWorld"> 

<result name="index">/index.jsp</result> 
</action> 
</package> 
</struts> 


<!-- 省 略 部 分 代码 --> 


在 配置 文件 中 ， 配 置 了 一 个 Hello World 的 Action， 它 的 Class 文件 是 HelloWorld 类 。 在 
action 节点 中 result 属性 用 来 配置 转发 页 面 ， 即 执行 成 功 后 的 页 面 地 址 。 

接 下 来 配置 Web.xml 文件 ， 这 里 主要 配置 filter 节点 Stmuts 2 的 过 滤器 和 接受 请 求 的 方式 ， 
设置 filter-class 为 org.apache.Struts 2.dispatcher.FilterDispatcher。 详 细 代码 如 下 所 示 。 


<!-- 省 略 部 分 代码 --> 
<?xml version="1.0" encoding="UTF-8"?> 
<Web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance™" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/Web-app 2 5.xsd"> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
<filter> 
<filter-name>struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping></Web-app> 
<!-- 省 略 部 分 代码 --> 
配置 好 Web.xml 后 ， Struts 2 框架 就 搭建 完成 了 一 部 分 。 接 下 来 进行 业务 处 理 阶段 ， 即 将 
户 名 提交 到 后 台 ， 经 过 处 理 后 返回 到 前 台 页 面 。 详 细 代 码 如 下 所 示 。 
<!-- 省 略 部 分 代码 --> 
public class HelloWorld extends ActionSupport{ 
private String username; 


public String getUsername() { 
return username; 
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public void setUsername (String username) { 
this.username = username; 
1 
public string out() 
二 
HttpServletRequest httprequest = ServletActionContext.getRequest (); 
httprequest .setAttribute ("ms",usernamet+" 说 : "Hello World""); 
return "index"; 
} 
3 
<!-- 省 略 部 分 代码 --> 


在 上 述 代码 中 ， 声 明了 一 个 username， 用 来 保存 用 户 form 提交 的 用 户 名 信息 ， 调 用 outO 
方法 ， 将 显示 的 信息 保存 到 request 对 象 里 面 ， 最 后 返回 页 面 。 页 面 显示 信息 代码 如 下 所 示 。 
<!-- 省 略 部 分 代码 --> 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"$%> 
<%@ taglib prefix="s" uri="/struts-tags" %> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 信 息 </title> 
</head> 


<body> 
<s:property value="#request .ms"/> 
</body> 
</html> 
<!-- 省 略 部 分 代码 --> 


在 页 面 应 用 标签 库 之 前 ， 需 要 将 标签 库 引 入 到 页 面 内 。 通 过 property 标签 使 信息 显示 在 前 
台 页 面 内 。 


1.3.4 ”运行 结果 
以 上 的 实例 代码 运行 后 的 效果 如 图 1-4 和 图 1-5 所 示 。 


[= 


窒 tm 天 | 基 位 息 


请 高 入 用 户 各 :admin [到 di 说，“Helo Workd™ 


图 14 用 户 名 输入 界面 图 1-5 显示 内 容 页 面 


<— 
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1.3.5 ”实例 分 析 


a 


本 节 以 一 个 Hello World 应 用 为 例 ， 简 要 介绍 了 Struts 2 MVC 框架 的 基本 流程 ， 从 Action 
类 基础 的 流程 控制 讲 起 ， 详 细 介 绍 了 如 何 开发 一 个 Struts 2 应 用 。 在 该 实例 后 面部 分 ， 在 基本 
的 Struts 2 应 用 基础 上 ， 介 绍 了 一 些 Struts 2 的 深入 应 用 ， 包 括 在 Action 中 访问 HttpSession 状 
态 ， 将 Action 处 理 的 结果 显现 在 前 台 JSP 页 面 内 。 同 时 还 讲解 了 Struts 2 的 标签 库 。 通 过 以 上 
实例 使 读者 对 Struts 2 有 了 进一步 的 了 解 。 


1.4 常见 问题 解答 


1.4.1 配置 struts.xml 时 ，class 路 径 错误 


区 | 配置 struts.xml 文件 时 ，class 路 径 错 误 ! 
[全 全 网 络 课堂 : http://bbs.itzen.com/thread- 10922-1-1.html 


在 配置 struts.xml 文件 ， 进 行 配置 Action 时 ， 经 常 在 启动 Tomcat 会 出 现 错误 信息 ， 如 图 
1-6 所 示 。 


图 1-6 运行 错误 


【解决 办 法 】 该 错误 出 现 的 原因 多 数 是 因为 在 配置 Action 节点 时 该 节点 的 class 元 素 路 径 
错误 ， 或 者 该 路 径 不 存在 。 


1.4.2 ”Struts 2 标签 库 引 用 错误 


Struts 2 标签 库 引 用 错误 ! 
网 络 课堂 : http://bbs.itzcn.com/thread-10927-1-1.html 

写 一 个 项 目 案例 ， 环 境 搭建 OK， 所 有 的 工作 都 准备 就 绪 后 ， 开 始 套 页 面 显 示 内 容 信息 ， 
可 是 当 将 Stmts 2 标签 库 引入 到 需要 的 JSP 页 面 时 ， 总 是 出 现 “Can not find the tag library 


Ed) > 
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descriptor for "/struts-tags" ”这样 的 错误 警告 。 

【解决 办 法 】 经 过 调查 ， 发 现 这 个 问题 的 主要 原因 在 于 没有 标签 库 ， 缺 少 类 库 ， 没 有 导 
入 Stmuts 2 中 标签 库 最 重要 的 一 个 JAR 包 Struts 2-core-2.1.8.1.jar。 所 以 读者 以 后 在 使 用 Struts 2 
时 一 定 要 注意 此 类 问题 。 


5 ,局 题 
一 、 填 空 题 
(1) 在 搭建 Stmts 2 时 ， 我 们 需要 导入 commons-fileupload-1.2.1.jar、commons-logging- 
1.0.4.jar、freemarker-2.3.15.jar、ognl-2.7.3.jar、xwork-core-2.1.6.jar 和 到 1lib 目录 下 。 


(2) Struts 2 核心 配置 文件 是 了 
(3) Struts 2 中 的 struts.xml 配置 文件 action 节点 的 作用 是 


(4) 若 将 一 个 普通 的 类 转换 成 Action 类 ， 只 要 继承 类 即 可 。 
二 、 选 择 题 
(1) 以 下 标签 ， 不 属于 Struts 2 中 的 标签 的 是 
A. set 的 标签 B. append 标签 
C.、 gererator 标签 D. 站 标 签 
(2) Struts 2 中 不 属于 Struts 2 的 主要 配置 文件 的 是 y 
A. Web.xml 配置 文件 B. struts.xml 配置 文件 
C. struts.properties 配置 文件 D.，applicationContext.xml 配置 文件 
(3) 下 属 选项 中 ， 不 属于 strut.xml 配置 文件 中 的 元 素 的 是 
A. package 元 素 B. file 元 素 
C. include 元 素 D. action 元 素 
三 、 上 机 练习 


上 机 练习 : 使 用 Struts 2 实现 用 户 注册 功能 。 

要 求 使 用 Struts 2 实现 用 户 注册 功能 ， 当 用 户 单 击 “提交 ”按钮 之 后 将 用 户 填写 的 用 户 信 
息 保存 到 数据 库 内 。 

运行 页 面 后 ， 要 在 页 面 内 显示 实体 的 属性 信息 ， 效 果 如 图 1-7 所 示 。 


1-7 ”用户 注册 


< 


完美 的 Struts 2 配置 


内 容 摘 要 : 

Struts 2 框架 的 配置 文件 分 为 两 类 : 内 部 使 用 和 供 开 发 人 员 使 用 。 内 部 配置 文件 由 Struts 2 
框架 自动 加 载 ， 对 其 自身 进行 配置 。 其余 的 配置 文件 由 开发 人 员 使 用 ， 用 于 对 Web 应 用 进行 
配置 。 本章 主要 围绕 Struts 2 中 的 各 项 配置 进行 介绍 。 如 Struts 2 的 相关 配置 文件 包括 web.xml、 
struts.xml 和 struts.properties 文件 等 ， 对 于 开发 人 员 ， 主 要 掌握 struts.xml 文件 的 配置 即 可 。 同 
时 重点 介绍 了 struts.xml 文件 的 配置 包含 Bean 配置、 常量 配 置 、 包 配置 、 命 名 空间 配置 等 。 讲 
解 了 Struts 2 的 核心 一 一 Action 的 实现 和 配置 还 有 与 Action 紧密 相关 的 Result 配置 ， 以 及 当 
Action 处 理 请 求 结束 时 ， 系 统 下 一 步 所 要 呈现 的 结果 。 最 后 还 简要 介绍 了 动态 结果 的 使 用 以 及 
Struts 2 异常 机 制 的 应 用 。 

学 习 目 标 : 

@@ 热 入 Strts2 的 基本 配置 。 
掌握 Struts 2 的 深入 配置 。 
熟悉 Action 的 配置 。 

热 悉 Result 的 配置 。 
理解 Result 的 动态 配置 。 
掌握 Struts 2 异常 机 制 的 应 用 。 
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2.1 小 小 图 书馆 


要 掌握 Struts 2 的 基本 配置 ， 读 者 不 要 去 死记 硬 背 ， 只 需 大 致 浏览 一 遍 基 础 知识 ， 有 一 些 
初步 印象 后 ， 再 结合 本 节 的 实例 应 用 ， 加 深 理 解 各 种 配置 的 具体 应 用 即 可 。 


= 视频 教学 : 光盘 /videos/02/config.avi @@ 长 度 : 7 分钟 
光盘 /videos/02/ web.xml.avi 人 @@ 长 度 : 10 分 名 
光盘 /videos/02/ struts.xml.avi @@ 长 度 :13 分钟 
光盘 /videos/02/ struts.properties.avi 加 长 度 : 5 分 钟 
光盘 /videos/02/ struts-default.xml.avi @@ 长 度 : 7 分 名 
光盘 /videos/02/ struts-plugin.xml.avi OO 长 度 : 5 分 钟 


2.1.1 基础 知识 Struts 2 的 基本 配置 


本 节 主 要 介绍 Struts 2 的 各 种 配置 文件 ， 如 struts.xml、struts.properties 等 ， 同 时 也 介绍 了 
Struts 2 在 web.xml 文件 中 的 配置 。 重点 要 掌握 的 是 web.xml、struts.xml 文件 中 的 各 项 配置 。 掌 
担 了 配置 文件 的 用 法 ， 才 能 更 好 地 使 用 和 扩展 Struts 2 框架 的 功能 。 


1. web.xml 


准确 地 说 ，web.xml 并 不 是 Struts 2 框架 特有 的 文件 。 作 为 部 署 描述 符 文 件 ，web.xml 是 所 
有 Java Web 应 用 程序 都 需要 的 核心 配置 文件 ， 起 着 初始 化 Servlet、Filter 等 Web 程序 的 作用 。 
对 于 Stmts 2 框架 而 言 ， 需 要 在 web.xml 文件 中 配置 一 个 前 端 控制 器 FilterDispatcher, 
用 于 对 Struts 2 框架 初始 化 和 处 理 所 有 的 请 求 。 
配置 FilterDispatcher 的 代码 片段 如 下 所 示 。 
<!-- 配置 struts 2 框架 的 核心 Filter --> 
<Ffilter> 
<!-- 配置 Struts 2 核心 Filter 的 名 字 --> 
<filter-name>struts</filter-name> 
<!-- 配置 struts 2 核心 Filter 的 实现 类 --> 
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher 
</filter-class> 
<init-param> 
<!-- 配置 struts 2 框架 默认 加 载 的 Action 包 结 构 --> 
<param-name>actionPackages</param-name> 
<param-value>org.apache.struts2.showcase.person</param-value> 
</init-param> 
<!-- 配置 struts 2 框架 的 配置 提供 者 类 --> 
<init-param> 
<param-name>configProviders </Param-name> 
<param-value>lee.MyConfigurationProvider</param-value> 
</init-param> 
</filter> 


mn) >> 
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<!-- 配置 Filter 拦截 的 URL--> 
<filter-mapping> 
<!-- 配置 struts 2 的 核心 filterDispatcher 拦截 所 有 用 户 请 求 --> 
<filter-name>struts</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 
FilterDispatcher 可 以 包含 一 些 初始 化 的 参数 ， 如 下 所 示 。 
1) config 
要 加 载 的 XML 配置 文件 的 列表 (以 逗号 分 隔 )。 如 果 没 有 设置 config 这 个 参数 ，Stmuts 2 框 
架 默 认 将 加 载 stuts-defaultxml、struts-plugin xml 和 struts xml 这 三 个 文件 。 
2) actionPackages 
以 逗号 分 隔 的 Java 包 名 的 列表 ，Struts 2 框架 将 扫描 这 些 包 中 的 Action 类 。 
3) configProviders 
实现 了 ConfigurationProvider 接口 的 Java 类 的 列表 (以 逗号 分 隔 )。 如 果 用 户 需 要 实现 自己 
的 ConfigurationProvider 类 , 用户 可 以 提供 一 个 或 多 个 实现 ConfigurationProvider 接口 的 类 , 然 
后 将 这 些 类 的 类 名 设置 成 该 属性 的 值 ， 多 个 类 名 之 间 以 英文 逗号 (,) 隔 开 。 
Wd 
任何 其 他 的 参数 被 当 作 是 Struts 2 的 常量 。 每 个 <init-param> 元 素 配置 一 个 Struts 2 常量 ， 
其 中 <param-name> 子 元 素 指定 了 常量 name， 而 <param-value> 子 元 素 指 定 了 常量 value 。 
<filter-mapping> 元 素 是 过 滤器 (Filten) 必 须 的 一 个 元 素 ， 用 于 过 滤 请 求 的 路 径 ， 此 处 一 般 设 为 /* 
形式 ， 对 所 有 请 求 uri 进行 拦截 (过 滤 )。 
配置 完 Struts 2 的 核心 控制 器 后 ， 基 本 完成 了 Stmts 2 在 web.xml 文件 中 的 配置 。 
@@、 如 果 web 容器 是 J2EE1.3(servlet2.3)， 由 于 不 会 自动 加 载 struts 的 标签 库 ， 所 以 需 
注意 要 在 web.xml 文件 中 手动 加 载 struts 的 标签 库 ， 文 件 名 struts-tags.tld， 一 般 放 在 
WEB-INF 下 面 ， 可 以 自己 指定 。 但 如 果 web 容器 是 J2EE1.4(servlet2.4), 那么 web 
容器 会 自动 加 载 标签 库 ，Struts 2 的 标签 库 定 义 文件 包含 在 struts2-core-2.0.6.jar 文 
件 里 ， 在 struts2-core-2.0.6.jar 文件 的 META-INF 路 径 下 ， 包 含 了 一 个 struts-tag.tld 
文件 。 


2. struts.xml 


struts.xml 文件 是 整个 Struts 2 框架 的 核心 。struts.xml 文件 内 定义 了 Struts 2 的 系列 Action 。 
定义 Action 时 ,指定 该 Action 的 实现 类 , 并 定义 该 Action 处 理 结果 与 视图 资源 之 间 的 映射 关系 。 
下 面 将 讲解 struts.xml 文件 的 具体 配置 。 该 示例 配置 代码 如 下 。 


<?xml Version="1.0"” encoding="UTF-8" ?> <!--XML 文件 标识 --> 
<!DOCTYPE struts PUBLIC <!- -文档 类 型 声明 --> 


"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<constant name="struts.il8n.reload" value="false" /> 
<constant name="struts.custom.il8n.resources" 
value="globalMessages"/> 
<include file="struts-chat.xml" /> <!-- 包 含 其 他 XML 文件 --> 


<E@—— 
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<include file="struts-validation.xml" /> 
<include file="struts-continuations.xml"/> 
<include file="struts-tags.xml"/> 

<!-- 配置 包 元 素 , 该 元 素 可 以 出 现 一 次 或 者 多 次 --> 


<package name="default" extends="struts-default"> <!-- 配 置 default 包 --> 


<interceptors> <!-- 拦 截 器 根 元 素 --> 
<interceptor-stack name="crudStack"> <!-- 拦 截 器 栈 --> 
<interceptor-ref name="checkbox" /> <! 一 -拦截 器 --> 


<interceptor-ref name="params" /> 

<interceptor-ref name="static-params" /> 

<interceptor-ref name="defaultstack" /> 
</interceptor-stack> 


</interceptors> 
<action name="showcase"> <!-- 配 置 Action--> 
<result>showcase.jsp</result> <!-- 配 置 Result--> 
</action> 
</package> 


<!-- 配置 employee 包 , 并 且 指 定 命名 空间 为 employee --> 
<package name="employee" extends="default" namespace="/employee"> 
<default-interceptor-ref name="crudSstack"/> <!-- 配 置 默认 拦截 器 --> 
<action name="list"class="org.apache.struts2.showcase.action. 
EmployeeAction" method="list"> 
<result>/empmanager/listEmployees.jsp</result> 
<interceptor-ref name="basicStack"/> 
</action> 
</package> 
</struts> 


在 该 配置 文件 中 ， 有 很 多 关键 属性 需要 读者 掌握 它们 的 特性 ， 简 介 如 下 。 

1) include 

include 节点 是 Struts 2 中 组 件 化 的 方式 ， 可 以 将 每 个 功能 模块 独立 到 一 个 XML 配置 文件 
中 ， 然 后 用 include 节点 引用 。 下 面 的 代码 就 是 利用 include 引入 struts-default.xml 文件 。 


<include file="struts-default.xml"></include> 


2) package 

package 提供 了 将 多 个 Action 组 织 为 一 个 模块 的 方式 。package 的 名 字 必 须 是 唯一 的 ， 
package 可 以 扩展 。 当 一 个 package 扩展 自 另 一 个 package 时 ,该 package 会 在 本 身 配置 的 基础 上 
加 入 扩展 的 package 配置 . 父 package 必须 在 子 package 前 配置 .可 以 为 package 配置 如 下 属性 。 

@ name: package 名 称 。 
extends: 继承 的 父 package 名 称 。 
abstract: 设置 package 的 属性 为 抽象 的 ， 抽 象 的 package 不 能 定义 Action。 
namespace: 定义 package 命名 空间 ， 该 命名 空间 将 影响 URL 地 址 。 例 如 此 命名 空间 
为 /test， 那 么 访问 是 的 地 址 为 “http://localhost:8080/struts2/test/XX.action”。 


由 于 struts.xml 文 件 是 自 上 而 下 解析 的 ,所 以 被 集成 的 package 要 放 在 集成 package 
注 窜 的 前 边 。 
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下 面 的 代码 配置 了 一 个 名 称 为 com.kay.struts2 的 包 ， 该 包 继 承 于 struts-default 文件 ， 该 包 

的 命名 空间 为 “/test”: 
<package name="com.kay.struts2" extends="struts-default" 

namespace="/test"> 

3) ”定义 拦截 器 

定义 拦截 器 ， 可 以 配置 如 下 属性 。 

@ name: 拦截 器 名 称 。 

@ class: 拦截 器 类 路 径 。 

<interceptors> 


<interceptor name="timer" class="com.kay.timer"></interceptor> 
<interceptor name="logger" class="com.kay.logger"></interceptor> 
<!-- 定义 拦截 器 栈 --> 
<interceptor-stack name="mystack"> 
<interceptor-ref name="timer"></interceptor-ref> 
<interceptor-ref name="logger"></interceptor-ref> 
</interceptor-stack> 
</interceptors> 


定义 默认 的 拦截 器 ， 每 个 Action 都 会 自动 引用 ， 如 果 Action 中 引用 了 其 他 的 拦截 器 ， 默 
认 的 拦截 器 将 无 效 。 下 面 引入 了 “mystack” 拦 截 器 栈 。 

<default-interceptor-ref name="mystack"></default-interceptor-ref> 

4) ”配置 全 局 Results 

下 面 是 定义 全 局 Results 配置 。 


<global-results> 
<result name="input">/error.jsp</result> 
</global-results> 


5) ”配置 Action 

配置 一 个 Action 可 以 被 多 次 映射 (只 要 Action 配置 中 的 name 不 同 )， 可 以 配置 如 下 属性 。 
@ name: Action 名 称 。 

@ class: 对 应 的 类 的 路 径 。 

@ method: 调用 Action 中 的 方法 名 。 


<action name="hello" class="com.kay.struts2.Action.LoginAction"> 


引用 拦截 器 ， 可 以 配置 name 属性 ， 指 定 要 引用 的 拦截 器 名 称 。 配 置 如 下 。 
@ name: 拦截 器 名 称 或 拦截 器 栈 名 称 。 


<interceptor-ref name="timer"></interceptor-ref> 


<E—— 
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6) 配置 Result 

一 个 Result 表示 一 个 可 能 的 输出 ， 它 有 如 下 两 个 配置 属性 。 

@ ”name: Result 名 称 和 Action 中 返回 的 值 相同 。 

@@ type: Result 类 型 不 写 则 选用 superpackage 的 type，struts-default.xml 中 的 默认 为 
dispatcher。 

<result name="success" type="dispatcher">/talk.jsp</result> 

7) ”Action 的 参数 设置 

配置 Action 可 以 将 一 个 请 求 URL 映射 到 一 个 action 类 。 它 只 有 一 个 name 属性 ， 该 属性 

对 应 Action 中 的 get/set 方法 。 


<param name="url">http://www.sina.com</param> 


3. struts.properties 
Stmts 2 的 属性 配置 文件 ， 默 认 叫 default.properties 文件 。 它 配置 Struts 2 的 默认 配置 。 这 
个 文件 提供 了 一 种 更 改 框架 默认 行为 方式 的 机 制 。 一 般 情 况 下 ， 如 果 不 是 打算 让 调试 更 加 方便 
的 话 ， 无 须 更 改 这 个 文件 。 
你 一 在 “struts.properties” 文 件 中 定义 的 属性 都 可 以 在 “web.xml” 文 件 的 “init-param” 
要 下 标签 中 进行 配置 ， 或 者 通过 “struts.xml” 文 件 中 的 “constant” 标 签 来 修改 。 
default.properties 文件 位 于 Struts 2 的 jar 包 中 ， 因 为 是 只 读 文件 ， 所 以 无 法 修改 ， 如 果 想 
要 修改 Struts 2 的 默认 配置 该 如 何 做 呢 ? 
首先 可 以 在 classpath 的 根 目 录 下 新 建 一 个 struts.properties 文件 。 创建 了 struts.properties 文 
件 之 后 ， 该 文件 中 的 属性 设置 会 覆盖 default.properties 文件 中 的 属性 设置 。 
例如 : 修改 Struts 2 的 默认 后 级 为 .do， 只 需 在 struts.properties 文件 中 写 入 如 下 代码 即 可 。 
struts.action.extension=do 
为 了 方便 读者 查看 ， 下 面 将 default.properties 文件 中 的 配置 常用 属性 列举 出 来 ， 如 表 2-1 
所 示 。 
表 2-1 default.properties 文件 常用 属性 


属性 名 


struts.action.extension 


说 明 
设置 Struts 2 的 后 缀 ， 默 认为 “action” 
org.apache.struts2.config.Configuration 接口 名 
Struts 2 自动 加 载 的 一 个 配置 文件 列表 ， 默 认 加 载 struts-default.xml、 
stmts-plugin.xml、struts.xml 
是 否 加 载 XML 配置 ， 默 认为 te 


struts.configuration 


struts.configuration.files 


struts.configuration. xml.reload 


m= > 
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De 
续 表 
属性 名 说 明 
struts.continuations package 含有 Action 完整 连续 的 package 名 称 
struts.custom .il 8n resources 加 载 附 加 的 国际 化 属性 文件 (不 包含 .properties 后 缀 ) 
struts.custom.properties 加 载 附加 的 配置 文件 的 位 置 


struts.enable.DynamicMethodInvocation 


允许 动态 方法 调用 ， 使 用 通配符 动态 调用 Action 


struts.il 8n.encoding 


国际 化 信息 内 码 编号 ， 默 认为 UTF-8 


struts.il 8n.reload 


是 否 国际 化 信息 自动 加 载 


struts.locale 


默认 的 国际 化 地 区 信息 


struts.multipart.maxSize 


multipart 请 求 信息 的 最 大 尺寸 文件 上 传 用 ) 


struts.multipart.parser 


专 为 multipart 请 求 信息 使 用 的 org.apache.struts2.dispatcher.multipart. 
MultiPartRequest 解析 器 接口 (文件 上 传 用 ) 


struts.multipart.saveDir 
struts.objectFacto 
struts.objectFactory.spring.autoWire 


struts.objectFactory.spring.useClassCache 


struts.serve.static.browserCache 


struts.serve.static 
struts.url.http.port 
struts.url.includeParams 
struts.velocity.confipfile 


struts.velocity.contexts 


4. struts-default.xml 


struts-default.xml 文件 为 Struts 2 框架 提供 了 默认 配置 ， 


设置 存储 上 传 文件 的 目录 
com.opensymphony.xwork2.ObjectFactory 接口 (spring) 
是 否 自 动 绑 定 Spring 

是 否 Spring 应 该 使 用 自身 的 cache 

是 否 Stmts 2 过 滤器 中 提供 的 静态 内 容 应 该 被 浏览 器 缓存 在 头 部 属 
性 中 

是 否 Struts 2 过 滤器 应 该 提供 静态 内 容 

设置 HTTP 端口 

在 URL 中 产生 默认 的 includeParams 

配置 文件 路 径 ， 默 认为 velocity.properties 
Velocity 的 context 列表 


Veloci 


是 框架 的 基础 配置 文件 ， 这 个 文件 


包含 在 struts2-core-2.0.11.jar 中 ， 由 框架 自动 加 载 。 
struts-default.xml 文件 会 自动 被 包含 到 struts.xml 文件 中 ， 以 提供 标准 的 配置 设置 而 不 需要 
复制 其 内 容 。 前 面 章节 中 在 介绍 配置 struts.xml 文件 时 ， 给 出 了 下 面 这 名 代码 。 


<package name="default" extends="struts-default"/> 


struts-default 包 就 是 在 struts-default.xml 文件 中 定义 的 ， 在 这 个 包 中 定义 了 Struts 2 内 署 的 
结果 类 型 (包括 Servlet 转发 、Servlet 重 定向 、FreeMarker 模板 输出 、XSTL 泻 染 和 ActionChain 
Result 等 ) 和 内 置 的 拦截 器 ， 以 及 由 不 同 拦截 器 组 成 的 拦截 器 栈 ， 这 些 拦 截 器 栈 可 以 直接 使 用 ， 
也 可 以 作为 自 定义 的 拦截 器 栈 的 基础 。 在 struts-default.xml 文件 的 最 后 还 定义 了 默认 的 拦截 器 


引用 。 
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5. struts-plugin.xml 


Struts 2 为 了 扩展 自身 的 功能 ， 提 供 了 类 似 于 Eclipse 的 插件 机 制 ， 插 件 以 Jar 包 的 方式 
提供 。 例 如 集成 Spring 的 插件 struts2-spring-plugin-2.0.11.jar， 集 成 Sitemesh 的 插件 struts- 
sitemesh-plugin-2.0.11.jar， 以 及 集成 Struts 1 的 插件 struts2-struts1-plugin-2.0.11.jar 等 。 

struts-plugin.xml 就 是 由 插件 使 用 的 配置 文件 ， 该 文件 的 结构 和 struts.xml 相同 ， 存 放 在 插 
件 Jar 包 的 根 路 径 中 。 如 果 读 者 不 是 开发 插件 的 话 ， 是 不 需要 编写 这 个 配置 文件 的 ， 作 为 普通 
开发 人 员 ， 更 多 的 是 使 用 插件 。 如 果 读 者 有 兴趣 开发 插件 ， 可 参看 Struts 2 开发 包 安装 目录 下 
的 docs/docs/plugins.html 文档 。 

下 面 介绍 一 个 struts-plugin.xml 文件 的 例子 ， 用 来 配置 Spring 插件 的 配置 文件 ， 其 代码 如 
下 所 示 。 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 

"http://struts.apache.org/dtds/struts-2.0.dtd"> 

<struts> 

<!-- 定 义 Spring 的 ObjectFactory --> 

<bean type="com.opensymphony .xwork2 .ObjectFactory"” name="spring" 

class="org.apache.struts2.spring.StrutsSpringObjectFactory" /> 

<!-- 将 SpringobjectFactory 设置 为 Struts 2 默认 的 ObjectFactory--> 

<constant name="struts.objectFactory" value="spring"/> 

<!-- 定义 spring-default 包 --> 

<package name="spring-default"> 

<!-- 配置 拦截 器 列表 --> 

<interceptors> 

<interceptor name="autowiring" 

class="com.opensymphony .xwork2.spring.interceptor. 

ActionAutowiringInterceptor"/> 

<interceptor name="sessionAutowiring" 


class="org.apache.struts2.spring.interceptor. 
SessionContextAutowiringInterceptor"/> 
) </interceptors> 
</package> 
</struts> 


0 struts-plugin.xml 文件 在 插件 加 载 时 ， 被 Struts 2 框架 自动 读 取 。 
提示 


2.1.2 ”实例 描述 


通过 学 习 Struts 2 的 基础 知识 , 可 能 读者 对 Struts 2 的 配置 理解 得 还 不 是 很 透彻 , 下 面 将 通 
过 一 个 “小 小 图 书馆 ”的 实例 来 深入 学 习 和 理解 Struts 2 的 基本 配置 。 


m= > 
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2.1.3 ”实例 应 用 


【 例 2-1】 小 小 图 书馆 。 
(1) 新 建 一 个 Struts2 2 项 目 ， 目 的 是 做 一 个 小 小 图 书馆 。 首 先导 入 Stmuts 2 相关 jar 包 ， 
并 在 项 目 WEB-INF/web.xml 文件 中 添加 Stmts 2 的 核心 控制 器 org.apache.struts2.dispatcher. 
FilterDispatcher， 代 码 如 下 所 示 。 


<?xml version="1.0" encoding="UTF-8"?> 

<web-app version="2.4" 
xmlns="http://java.sun.com/xml/ns/j2ee" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance™ 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app 2 4.xsd"> 
<filter> 

<filter-name>struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter- 
class> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>/*</url-pattern><!-- 配置 拦截 所 有 请 求 url --> 
</filter-mapping> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
</web-app> 


(2) 接着 在 项 目的 sre 目录 下 新 建 一 个 struts.xml 文件 ， 输 入 如 下 代码 。 


<?xml] Version="1.0"” encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 

</struts> 


(3) 在 Struts2 2 项目 目录 下 ， 新 建 一 个 loginjsp 文件 ， 代 码 如 下 所 示 。 


<%@ page contentType="text/html; charset=utf-8" language="java" 
import="java.sql.*" errorPage="" $> 

<%@ taglib prefix="s" uri="/struts-tags"%®> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 

<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<title>Login</title> 

</head> 
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<body> 
<s:form action="GetBooks.action"> 
<s:textfield name="username"” label=" 用 户 名 " /> 
<s:password name="password" label=" 密 码 " /> 
<s:submit value=" 提 交 " /> 
</s:form> 
</body> 
</html> 


(4) 在 src/books 目录 下 建立 Action 接口 ， 代 码 如 下 所 示 。 


package books; 

public interface Action 

{ 
public static String SUCCESS = "success"; 
public static String NONE = "none"7 
public static String ERROR = "error"; 
public static String INPUT = "input"; 
public static String LOGIN = "login"; 


public String execute () throws Exception; 


} 
(5) 定义 一 个 储存 数据 的 BooksServicejava( 实 际 中 不 可 能 这 样 用 ， 这 里 只 是 为 了 方便 演 


示 )， 代 码 如 下 所 示 。 


Package books; 
Public class BooksService 
{ 
// 下 面 是 要 用 的 图 书 数据 ， 在 此 为 了 方便 演示 ， 所 以 没有 从 数据 库 中 加 载 数 据 。 
private String[] books = new String[]{"Spring2.0 宝典 ", " 轻 最 级 J2EE 企业 应 用 
实战 ", "基于 Ajax 的 在 线 订购 系统 ", "Struts, spring ,habernate 整合 开发 "}; 
// 获 取 图 书信 息 数据 方法 ， 此 方法 相当 于 连接 数据 时 ， 从 数据 库 中 查询 获取 图 书信 息 数据 。 
Public String[] getLeeBooks () 
{ 
return books; 
L 
} 


(6) 图 书馆 是 要 登录 的 ， 既 然 要 登录 ， 那 么 登录 验证 是 必 不 可 少 的 ， 登 录 进 去 之 后 可 以 看 


到 馆 内 的 图 书信 息 列表 ， 所 以 需要 定义 一 个 登录 验证 并 转 入 书籍 列表 类 GetBooksAction.java， 
代码 如 下 所 示 。 


package books; 
import com.opensymphony .xwork2.ActionContext; 
public class GetBooksAction implements Action 
{ 
private String[] books; // 图 书信 息 数 据 
private String username; // 用 户 名 
private String password; // 密 码 
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public void setBooks (String[] books) // 设 置 图 书信 息 数 据 
{ 
this.books = books; 


public string[] getBooks () // 获 取 图 书信 息 数 据 
{ 
return books; 


public String getUsername () // 获 取 用 户 名 
{ 


return this.username; 


public String getPassword() // 获 取 密 码 
{ 


return this.password; 


public void setUsername (String username)  ”// 设 置 用 户 名 
{ 

this.username = username; 
} 
public void setPassword(String password) // 设 置 密码 
{ 


this.password = password; 


public String execute()throws Exception 
1 
// 验 证 用 户 登 录 的 用 户 名 与 密码 是 否 正确 
if (getUsername () .equals ("admin")&&getPassword() .equals ("admin")) 
{ 
// 用 户 名 正确 将 用 户 名 放 入 到 ActionContext 的 Session 中 “user” 参 数 
ActionContext .getContext () .getSession() .put ("user",getUsername () ) 
} 
else 
上 
// 用 户 名 不 正确 将 “error” 放 入 到 ActionContext 的 Session 中 “user” 参 数 
ActionContext .getContext () .getSession() .put ("user", "error"); 
// 从 session 中 取出 “user” 参 数 
String user = (String)ActionContext.getContext() .getSession(). get 
("user™); 
System.out .println((String)ActionContext .getContext () .getSession(). 
get ("user"™)); 
// 判 断 “user” 是 否 equalse ("admin") 
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if(user!=nullgg&user.equals ("admin")) 
. 
// 登 录 成 功 了 , 创建 BooksService 业务 类 , 调用 bs 的 getLeeBooks () 方 法 获取 图 


书信 息 
BooksService bs = new BooksService(); 
setBooks (bs .getLeeBooks ()); // 设 置 Action 的 books 
return SUCCESS; // 返 回 登录 成 功 
} 
else 
// 否 则 返回 重新 登录 


return LOGIN; 


» 
(7) GetBooksAction 创建 好 之 后 ， 需 要 在 struts.xml 文件 中 配置 Action， 代 码 如 下 所 示 。 


<include file="struts-default.xml"></include> 
<package name="Struts2 2" extends="struts-default"> 
<action name="GetBooks" class="books.GetBooksAction"> 
<result name="login">/login.jsp</result> 
<result name="success">/showBooks.jsp</result> 
</action> 
</package> 


(8) 最 后 一 步 需要 创建 一 个 显示 书籍 页 面 showBooks.jsp， 代 码 如 下 所 示 。 


<%@ page contentType="text/html; charset=utf-8" language="java" 
import="java.sql.*" errorPage="" $%> 
<%@ page import="java.util.*,com.opensymphony.xwork2.util.*"%®> 
<%@ taglib prefix="s" uri="/struts-tags"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtmll1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.o0rg/1999/xhtml"> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<title>showBooks</title> 
</head> 
<body> 

<s:iterator value="books" status="index"> <! 一 使 用 struts2 友 代 标签 , 迭代 
books 数组 --> 

<s:if test="#index.odd==true"> <!-- 使 用 struts2 判断 标签 --> 

<span style="color:#FF0000"><s:property /></span><br /> 
</s:if> 
<s:else> 
<s:property /><br /> 

</s:else> 

</s:iterator> 
</body> 
</html> 
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2.1.4 运行 结果 
;看 


现在 来 看 看 所 建立 的 “小 小 图 书馆 ”。 运 行 的 login.jsp 页 面 。 执 行 效果 如 图 2-1 所 示 。 


图 2-1 图 书馆 登录 界面 


当 用 户 输入 用 户 名 admin 和 密码 atmin， 单 击 【登录 】 按 钮 时 ， 如 果 登 录 成 功 ， 读 者 可 以 
看 到 图 书馆 的 图 书信 息 , 如 果 登 录 失败 , 将 让 用 户 再 次 登录 。 执行 显示 图 书信 息 的 效果 如 图 2-2 


图 书信 息 
Sor oF 


三 量 俩 )2EE 让 业 应 用 天 枚 
ra 


Struts,spring .hibernate 区 名 开导 


2-2 ”图书 信息 


2.1.5 “实例 分 析 


a 


上 述 实例 创建 一 个 login.jsp 页 面 ,用 于 用 户 登录 该 图 书馆 系统 ,并 通过 创建 GetBooksAction 
来 验证 用 户 登 录 ,登录 成 功 之 后 ,创建 BooksService 来 载 入 显示 图 书信 息 .最 终 在 showBooks.jsp 
页 面 中 显示 图 书信 息 。 
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2.2 配置 Struts 2 的 命名 空间 


cS 视频 教学 : 光盘 /videos/02/bean.avi 长 度 : 9 分 名 
光盘 /videos/02/constant.avi Ok 度 : 7 分 名 
光盘 /videos/02/ package.avi @@ 长 度 : 5 分 名 
光盘 /videos/02/ namespace.avi 人 @ 长 度 : 9 分 名 
光盘 /videos/02/ Include.avi @@ 长 度 : 5 分 钟 


2.2.1 基础 知识 深入 Struts 2 的 配置 文件 


Struts 2 的 struts.xml 配置 文件 的 结构 包括 该 文件 的 根 元 素 及 每 个 元 素 能 包含 的 子 元 素 等 。 
本 节 将 讲解 深入 配置 ， 包 括 Bean 的 配置 、 常 量 配置 、 包 配置 和 命名 空间 配置 等 。 
1. Bean 


Struts 2 框架 以 可 配置 的 方式 来 管理 Struts 2 的 核心 组 件 ， 从 而 允许 开发 者 可 以 很 方便 地 扩 
展 该 框架 的 核心 组 件 。 当 开发 者 需要 扩展 或 者 替换 Struts 2 的 核心 组 件 时 ， 只 需要 提供 自己 的 
组 件 类 ， 并 将 该 组 件 实现 类 部 署 在 Struts 2 的 IOC 容器 即 可 。 

在 struts.xml 文件 中 定义 Bean 时 ， 通 常 有 如 下 两 个 作用 。 

(1) 框架 的 IOC 容器 创建 Bean 的 实例 ， 然 后 将 该 实例 注入 框架 的 内 部 对 象 中 。 

(2) 通过 Bean 的 静态 方法 向 Bean 注入 值 。 

在 第 一 种 用 法 中 ，Bean 将 被 注入 框架 内 部 ， 和 内 部 对 象 协作 ， 框 架 要 知道 Bean 的 类 型 ， 
因此 在 配置 Bean 时 , 通常 要 使 用 type 属性 , 以 指明 Bean 实现 的 接口 .如 创建 一 个 ObjectFactory， 
需要 在 struts.xml 文件 中 使 用 Bean 元 素 配 置 ， 代 码 如 下 所 示 。 

<bean type="com.opensymphony .xwork2.0bjectFactory" name="myfactory" 

class="com.company.myapp.MyObjectFactory"/> 

， 对 于 第 二 种 用 法 ， 使 用 值 注 入 ， 人 允许 不 创建 Bean， 而 是 让 Bean 接收 框架 的 常量 。Bean 
使 用 值 注入 ， 必 须 使 用 static 属性 ， 并 将 该 属性 设置 为 true。 例 如 配置 FilterDispatcher。 


<bean class="org.apache.struts2.dispatcher.FilterDispatcher" static="true"/> 


》 ”对 于 绝 大 部 分 Struts 2 应 用 而 言 ， 因 为 无 需 重新 定义 Struts 2 框架 的 核心 组 件 ， 因 
提示 此 也 就 无 需 在 文件 中 定义 Bean。 


Bean 元 素 的 几 个 属性 如 表 2-2 所 示 。 

2. 常量 

通过 配置 常量 ， 可 以 改变 Struts 2 框架 和 插件 的 行为 ， 从 而 满足 不 同 Web 应 用 的 需求 。 实 
际 上 ， 配 置 常量 就 是 配置 Stmts 2 的 属性 。 常 量 可 以 在 多 个 文件 中 声明 。 默 认 地 ，Struts 2 框架 
按照 下 列 文件 的 顺序 搜索 常量 ， 越 靠 后 的 文件 优先 级 越 高 ， 也 就 是 说 ， 顺 序 靠 后 的 文件 中 的 常 
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量 设置 可 以 覆盖 顺序 靠 前 的 文件 中 的 常量 设置 。 文 件 加 载 顺 序 如 下 所 示 。 
(1) struts-default.xml: 存放 在 struts2-core-x.x.x.jar 文件 中 。 
(2) struts-plugin.xml: 存放 在 struts2-xxx-x.x.x.jar 等 Struts 2 插件 的 Jar 文件 中 。 
(3) struts.xml: Web 应 用 中 默认 的 Struts 2 配置 文件 。 
(4) struts.properties: Struts 2 的 属性 配置 文件 。 
(5) web.xml: Web 应 用 的 配置 文件 。 


表 2-2 Bean 元 素 的 属性 


bean 的 类 名 
bean 类 实现 的 接口 

bean 的 名 字 ， 在 具有 相同 type 属性 的 bean 中 ， 该 名 字 必 须 是 唯一 的 
bean 的 范围 ， 有 效 的 值 包括 : default、singleton、request、session 和 thread 
是 否 使 用 静态 方式 注入 , 如 果 指 定 了 type 属性 , 则 不 要 把 该 属性 设 为 true 


在 struts.xml 文件 中 ， 通 过 <constant> 节 点 配置 常量 (Constant)， 可 以 作为 指定 Struts 2 属性 
的 一 种 方式 。 而 Struts 2 的 常量 既 可 以 在 struts.xml 文件 中 配置 ， 也 可 以 在 struts.properties 文件 
中 配置 ， 在 其 他 一 些 配 置 文件 中 也 可 以 实现 。 
如 果 在 多 个 文件 中 配置 同一 个 Struts 2 常量 ,按照 加 载 顺 序 , 后 一 个 文件 中 配置 的 
注意 常量 值 将 会 覆盖 前 面 文件 中 配置 的 常量 值 。 


使 用 <constant> 元 素 配置 常量 时 ， 需 要 指定 以 下 两 个 必 填 属性 。 

® name: 量 的 名 称 。 

@ value: 指定 常量 的 属性 值 。 

例如 ， 在 struts.xml 文件 中 ， 指 定 字符 编码 集 为 gb2312， 代 码 如 下 。 

<constant name="struts.il8n.encoding" value="gb2312"/> 

在 struts.xml 文件 中 ， 指 定 国际 化 资源 文件 的 basename 为 globalMessages， 代 码 如 下 。 
<constant name="struts.custom.il8n.resources" value="globalMessages" /> 
如 果 使 用 struts.properties 文件 实现 上 述 常 量 的 配置 ， 代 码 如 下 。 


struts.il8n.encoding=gb2312 
struts.custom.il8n.resources=globalMessages 


”在 struts.properties 文件 中 ,文件 的 内 容 使 用 键 值 对 Key-Value 的 形式 ， 其 中 Key 
提示 对 应 Struts 2 常量 中 的 name，Value 对 应 Struts 2 常量 的 value 等 。 


使 用 web.xml 文件 同样 可 以 实现 上 述 常 量 的 配置 ， 代 码 如 下 所 示 。 


<filter> 
<filter-name>struts2</filter-name> 
<filter-class> 
org.apache.struts2.dispatcher.FilterDispatcher 


2 配置 
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</filter-class> 
<init-param> 


<param-name> 
struts2.custom.il8n.resources 
</param-name> 
<param-value>globalMessages</param-value> 
</init-param> 
<init-param> 
<param-name>struts.il8n.encoding</param-name> 
<param-value>gb2312</param-value> 
</init-param> 


</filter> 
通过 上 述 代码 可 以 看 出 ,在 web.xml 文件 中 配置 常量 时 ,需要 在 <filter> 元 素 中 使 用 子 元 素 
<init-param> 来 实现 。 


如 果 将 Struts 2 常量 配置 在 web.xml 文件 中 ， 实 现 同样 的 功能 ， 代 码 量 会 明显 增 
提示 加 , 而且 降低 了 web.xml 文件 的 可 读 性 。 所 以 推荐 将 Struts 2 常量 配置 在 struts.xml 
文件 进行 集中 管理 。 
3. 包 


在 Struts 2 框架 中 ， 其 核心 组 件 是 Action 和 拦截 器 等 ， 该 框架 使 用 包 来 管理 这 些 组件 。 在 
包 中 可 以 配置 多 个 Action、 多 个 拦截 器 或 者 是 多 个 拦截 器 引用 的 集合 等 。 使 用 <package> 元 素 
配置 包 时 ， 可 以 指定 4 个 属性 ， 如 表 2-3 所 示 。 


表 2-3 <package> 元 素 的 属性 


namespace 


abstract 


@m， 如 果 使 用 extends 继承 其 他 包 ， 则 子 包 可 以 继承 父 包 中 的 拦截 器 和 Action 等 。 但 
技巧 是 父 包 必须 在 子 包 前 面 定 义 。 


例如 ， 在 struts.xml 文件 中 配置 两 个 包 ， 配 置 方式 的 代码 如 下 所 示 。 


<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 

<constant name="struts.il8n.encoding" value="gb2312"/> 

<package name="default" extends="struts-default"> <!-- 配 置 default 包 --> 

<interceptors> 
<interceptor-stack name="myStack"> 
<interceptor-ref name="defaultStack"/> 
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<interceptor-ref name="myInterceptor"/> 
</interceptor-stack> 
</interceptors> 
<action name="actionl" class="RctionClassl"> <!-- 配 置 Action--> 
<result name="success">/success.jsp</result> 
</action> 
</package> 
<package name="myPackage" extends="default" namespace="/skill"> 
<!-- 配 置 myPackage 包 , 并 且 指 定 命名 空间 --> 
<default-interceptor-ref name="myStack"/> <!--myStack 拦截 器 --> 
<action name="action2" class="RctionClass2"> <!-- 配 置 Action--> 
<result name="success">/success.jsp</result> <!-- 配 置 Result--> 


<interceptor-ref name="defaultstack"/> <!-- 使 用 默认 拦截 器 --> 
<interceptor-ref name="myInterceptor"/> <!-- 使 用 myStack--> 
</action> 
</package> 


</struts> 


上 述 文 件 中 ， 配 置 default 包 ， 配 置 myPackage 包 ， 在 包 中 配置 有 拦截 器 和 Action。 其 中 ， 
default 包 继承 Struts 2 框架 的 默认 包 struts-default; myPackage 包 继承 default 包 。 
4. 命名 空间 
Struts 2 通过 为 包 指定 namespace 属性 来 为 包 下 面 的 所 有 Action 指定 共同 的 命名 空间 ， 同 
-个 命名 空间 不 能 有 同名 的 Action。 

<package name="struts2" extends="struts-default"> 

<package name="my" extends="struts-default" namespace="/manage"> 

上 面 配置 了 两 个 包 : struts2 和 my， 配 置 my 包 时 指定 了 该 包 的 命名 空间 为 /manage。 

@ 包 strmts2: 没有 指定 namespace 属性 。 如 果 某 个 包 没有 指定 namespace 属性 ， 即 该 包 
使 用 默认 的 命名 空间 ， 默 认 的 命名 空间 总 是 ""。 

@ 包 my: 指定 了 命名 空间 /manage， 因 此 该 包 下 所 有 的 Action 处 理 的 URL 应 该 是 “ 命 
名 空间 /Action 名 ”。 

Struts 2 先 在 指定 的 路 径 下 找 Action， 如 果 找 不 到 则 会 去 默认 的 路 径 下 找 Action 。 

5. 包含 (Include) 配 置 


在 大 型 的 Web 项 目 中 ， 为 了 降低 项 目的 复杂 度 ， 便 于 团队 成 员 分 工 合作 ， 通 常 将 项 目 划 
分 为 多 个 小 模块 ， 每 个 模块 单独 开发 与 管理 。Stmuts 2 也 提供 了 这 种 “分 而 治之 ”的 策略 。 我 
们 可 以 为 每 个 小 模块 提供 一 个 配置 文件 ， 对 其 进行 配置 ， 然 后 在 struts.xml 文件 中 使 用 include 
元 素来 包含 其 他 的 配置 文件 。 

include 元 素 必 须 有 一 个 属性 fle， 指 定 被 包含 文件 的 文件 名 。 例 如 使 用 include 元 素 ， 在 
struts.xml 文件 中 引入 一 个 struts-tags.xml 文件 ， 代 码 如 下 所 示 。 

<?xml version="1.0" encoding="UTF-8" ?> 


<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 


< 四 mm 
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"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
<include file="struts-tags.xml"/> 
</struts> 


2.2.2 ”实例 描述 


在 网 上 论坛 中 有 人 提出 了 一 个 问题 ， 说 他 定义 了 一 个 LoginAction 用 于 登录 系统 ， 在 
struts.xml 文件 中 也 配置 好 了 ， 但 当 他 使 用 “项 目 名 /login.action” 时 ， 没 有 访问 到 这 个 Action， 


这 是 怎么 回 事 呢 ? 


这 个 问题 深 深 地 吸引 了 我 , 我 让 他 把 他 的 LoginAction 和 struts.xml 文件 中 的 配置 代码 ， 粘 


贴 到 论坛 中 ， 我 帮 他 看 看 ， 我 一 看 ， 悦 然 大 悟 蚜 ， 他 使 用 了 命名 空 


间 的 配置 。 知 道 他 的 出 错 原 


因 了 , 这 就 好 办 了 , 将 请 求 URL 中 添加 入 命名 空间 , 即 可 请 求 成 功 。 本 节 的 实例 将 演示 Struts 2 


命名 空间 的 配置 以 及 如 何 请 求 使 用 。 


2.2.3 ”实例 应 用 


【 例 2-2】 配置 Stmuts 2 的 命名 空间 。 


(1) 首先 在 项 目的 src 目录 下 新 建 一 个 com.namespace 包 ， 在 该 包 下 新 建 一 个 NameSpace 


Action， 用 来 处 理 用 户 请 求 ， 代 码 如 下 所 示 。 


public class NameSpaceAction { 


private String username; // 用 户 名 


private String password; // 密 码 


public String getUsername() { 
return username; 


让 


public void setUsername (String Username) 1 


this.username = username; 


1 


public String getPassword() { 
return password; 


由 


public void setPassword(String password) { 


this.password = password; 


} 


public String execute(){ 


System.out .println ("execute 方法 被 调用 "); 


return "SUCCESS"7 
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public String methodTest (){ 
System.out .println ("methodTest 方法 被 调用 aaaaaaaa"); 
return "SUCCESS"; 


} 


(2) 在 src 目录 下 的 strmutsxml 文件 中 配置 NameSpaceAction， 并 指定 不 同 的 namespace 来 
配置 Action， 代 码 如 下 所 示 。 


<!-- 默认 命名 空间 , 即 不 写 namespace 或 者 写 namespace="", 在 前 端 不 指明 命名 空间 
的 时 候 或 随便 写 非 命名 空间 名 字 的 时 候 用 到 --> 
<package name="struts2" extends="struts-default"> 
<action name="login" class="com.namespace.NameSpaceAction"> 
<result name="SUCCESS">/jsp/success.jsp</result> 
</action> 
</package> 
<package name="testl" extends="struts-default" namespace="/testl1l"> 
<action name="login" class="com.namespace.NameSpaceAction"> 
<result name="SUCCESS">/jsp/testl1.jsp</result> 
</action> 
</package> 


<package name="test2" extends="struts-default" namespace="/test2"> 
<action name="login" class="com.namespace.NameSpaceAction"> 
<result name="SUCCESS">/jsp/test2.jsp</result> 
</action> 
</package> 
<package name="test3" extends="struts-default" namespace="/test3"> 
<action name="login" class="com.namespace.NameSpaceAction"> 
<result name="SUCCESS">/jsp/test3.jsp</result> 
</action> 
</package> 
<!-- 根 命名 空间 ， 只 用 /来 命名 命名 空间 的 时 候 用 到 --> 
<package name="test4" extends="struts-default" namespace="/"> 
<action name="login" class="com.namespace.NameSpaceAction"> 
<result name="SUCCESS">/jsp/test4.jsp</result> 
</action> 
</package> 
<!-- 执行 非 execute 方法 的 配置 方式 --> 
<package name="struts22" extends="struts-default" namespace="/test5"> 
<action name="loginl" class="com.namespace.NameSpaceAction"> 
<result name="SUCCESS">/jsp/test5.jsp</result> 
</action> 
<action name="login2" class="com.namespace.NameSpaceAction™" 
method="methodTest"> 
<result name="SUCCESS">/jsp/test5.jsp</result> 
</action> 
</package> 


(3) 在 项 目下 新 建 一 个 namespace.jjsp 页 面 ， 在 这 个 页 面 中 定义 一 个 登录 表单 和 几 个 链接 ， 
分 别 使 用 不 同 的 命名 空间 发 出 请 求 ， 代 码 如 下 所 示 。 


<B— 
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<form action="<%=basePath%>login.action" method="post"> 
用 户 名 :<input type="text" name="username"><br> 

密码 :<input type="text" name="password"><br> 

<input type="submit" value=" 登 录 " > 

</form> 

<br> 

<a href="<s=-basePaths>test1/1ogin.action"> 命 名 空间 1 进行 登录 </a> 

<a href="<%=basePath%>test2/1ogin.action"> 命 名 空间 2 进行 登录 </a> 

<a href="<%=basePath%>test3/1ogin.action"> 命 名 空间 3 进行 登录 </a> 

<a href= =basePath%>/1login.action"> 根 命名 空间 进行 登录 </a><!-- 根 命名 空间 --> 
<a href="<%=basePath%>test5/1loginl!methodTest.action"> 命 名 空间 51 进行 登录 </a> 
<a href="<%=basePath%>test5/1ogin2.action"> 命 名 空间 52 进行 登录 </a> 


(4) 使 用 默认 命名 空间 登录 成 功 后 跳 转 到 登录 成 功 提示 页 面 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 默 认命 名 空间 </title> 
</head> 
<body> 
默认 命名 空间 , 登录 成 功 ! <br> 
</body> 
</html> 


(5) 由 于 上 而 namespace.jsp 页 面 中 的 各 个 链接 单 击发 出 请 求 不 同 命名 空间 的 login.action， 
最 终 跳 转 到 Action 配置 成 功 的 页 面 如 testl 命名 空间 ， 即 跳 转 到 /jsp/testl.jsp 页 面 ， 该 页 面 代码 
如 下 所 示 。 

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 

<html> 

<head> 

<title>testl 命名 空间 </title> 
</head> 
<body> 

testl 命名 空间 , 登录 成 功 ! <br> 
</body> 

</html> 


名 本 实例 还 有 test2.jsp、test3.jsp、test4.jsp、test5.jsp， 这 些 和 testl.jsp 差不多 一 样 ， 
提示 只 是 提示 请 求 某 个 命名 空间 的 login.action 登录 成 功 了 。 在 此 不 再 作 介绍 ， 具 体 可 
查看 Struts2_2/jsp 目录 下 这 几 个 文件 的 源码 。 
2.2.4 运行 结果 
运行 namespace.jsp 页 面 ， 单 击 链接 ， 请 求 不 同 命名 空间 的 Action， 进 行 登录 ， 执 行 效果 


Eee >> 
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如 图 2-3 所 示 。 单 击 下 面 各 个 命名 空间 登录 ， 如 : 单 击 “ 命 名 空间 1 进行 登录 ”， 执 行 效 果 如 
图 2-4 所 示 。 


地 址 栏 中 ul 添加 上 | -| 
了 testl 命名 空间 | 


DE Pr 


图 2-3 不 同 的 命名 空间 登录 图 2-4 test1 命名 空间 登录 成 功 


2.2.5 ”实例 分 析 


i 


在 本 实例 中 ， 我 们 将 NameSpaceAction 在 struts.xml 文件 中 配置 到 不 同 的 命名 空间 中 ， 这 
样 便 可 以 在 请 求 URL 地 址 中 添加 入 不 同 的 命名 空间 ， 如 “http://localhost:8080/Struts2_ 
2/testl/login.action” 。 至 此 ， 相 信 读 者 已 经 知道 如 何 配置 使 用 struts.xml 文 件 中 的 命名 空间 了 。 


2.3 管理 用 户 


Action 的 配置 是 Struts 2 框架 的 一 个 基础 工作 单元 ， 每 一 个 Action 的 配置 都 有 对 应 的 处 理 
类 ， 当 一 个 请 求 和 Action 的 name 相 匹 配 时 , 框架 将 根据 所 配置 的 Action 映射 来 决定 对 请 求 的 
处 理 。Struts 2 Action 几乎 完全 吸收 了 WebWeork 的 精华 , 本 节 将 先 总 结 一 下 Action 的 配置 方法 。 


9 
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2.3.1 基础 知识 Action 的 配置 


首先 来 看 一 下 com.opensymphony.xwork2.Action 的 接口 声明 ，Action 提供 execute0 方 法 ， 
子 类 必须 实现 execute0 方 法 。 
public interface Action { 


public String execute () throws Exception; 
} 


<@—— 
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》 com.opensymphony.xwork2.ActionSupport 是 com.opensymphony.xwork2.Action 的 
默认 实现 ， 实 现 了 execute0 方 法 。 
Action 通常 继承 com.opensymphony.xwork2.ActionSupport。 


入 
六 


1. 简单 的 Action 配置 
如 下 所 示 为 一 个 Action 的 配置 代码 。 


<action name="logon" class="tutorial.Logon"> 
<result type="redirect-action">Menu</result> 
<result name="input">/tutorial/Logon.jsp</result> 
</action> 


前 台 发 送 调 用 logon.action 的 请 求 ， 监 听 器 调用 默认 的 execute0 方 法 。 

2. 一 个 方法 一 个 Action 配置 

在 开发 中 通常 将 多 个 方法 写 在 一 个 Action 中 ， 这 样 Action 便 可 以 采用 集中 配置 方式 。 下 
面 来 看 看 如 何 用 一 个 方法 配置 一 个 Action， 代 码 如 下 所 示 。 

<action name="delete" class="example.CrudAction" method="delete"> 

3. 通配符 方式 

采用 “*” 号 通配符 来 配置 Action， 代 码 如 下 所 示 。 

<action name="*Crud" class="example.Crud" method="{1}"> 


method="{1}" 表 示 第 一 个 通配符 是 方法 。 
Action 调用 的 例子 : addCrud.action、deleteCrud.action、updateCrud.action、viewCrud.action。 


4. 分 割 符 加 上 * 
分 割 符 可 以 是 “”、“! ”等 。 下 面 使 用 “_ ”分 割 符 来 配置 Action， 代 码 如 下 所 示 。 


<action name="crud *" class="example.Crud" method="{1}"> 


调用 方式 : crud_add.action、crud_delete.action。 
“!” 的 使 用 是 否 和 “_” 一 样 呢 ? 它们 是 不 一 样 的 ，“!” 代 码 如 下 所 示 。 


<action name="crud!*" class="example.Crud" method="{1}"> 


调用 方式 : crud!add.action、crud!delete.action。 
5. URL 映射 规则 
“/User/add.action” 调 用 User 的 add 方法 ， 其 配置 代码 如 下 所 示 。 


<action name="*/*" method="{2}" class="com.infoq.actions.{1}Action"> 
<result type="redirect">/{1}/view.action</result> 
<result name="view">/{1}/view.jsp</result> 
<result name="input">/{1}/edit.jsp</result> 
<result name="home">/{1}/home.jsp</result> 
</action> 
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2.3.2 ”实例 描述 


昨天 夜里 突然 接 到 一 个 朋友 的 电话 ， 当 时 他 在 加 班 ， 在 看 公司 以 前 的 一 个 项 目 ， 这 个 项 目 
现在 要 进行 升级 优化 。 但 这 个 项 目的 Struts 2 配置 文件 写 的 太 乱 了 ， 而 且 代码 很 多 。 他 看 了 很 
久 也 不 知道 如 何 着 手 修 改 ， 万 分 着 急 和 无 奈 之 下 ， 他 向 我 抱怨 工作 难度 太 大 。 的 确实 如 此 ， 配 
置 文件 多 本 来 就 是 件 让 人 头疼 的 事 ， 对 他 我 深 表 同情 。 所 以 ， 读 者 将 来 编程 时 ， 一 定 不 要 使 用 
太 多 的 配置 文件 ， 可 以 采用 通配符 、 分 割 符 等 ， 将 一 些 类 似 的 Action 配置 统一 配置 成 一 个 
Action, 这 样 别 人 看 起 来 也 有 条 理性 ,配置 文件 也 会 减少 许多 。 别 人 看 你 的 程序 也 就 容易 多 了 。 

本 节 的 实例 是 如 何 只 在 struts.xml 文件 中 配置 一 个 Action， 就 可 以 对 用 户 进行 “增删 查 改 ” 
的 操作 。 


2.3.3 ”实例 应 用 


【 例 2-3】 管理 用 户 。 

(1) 实际 开发 中 ， 对 用 户 的 管理 操作 是 非常 频繁 的 ， 现 在 做 一 个 管理 用 户 的 实例 ， 主 要 就 
是 “ 增 ”、“ 删 ”、“ 查 ”、“ 改 ”。 在 项 目的 src 下 创建 一 个 com.cqxs.action 包 ， 在 该 包 下 
新 建 一 个 UserAction， 用 于 处 理 用 户 操 作 的 请 求 ， 代 码 如 下 所 示 。 

package com.cqxs.action; 


import com.opensymphony .xwork2.ActionSupport; 
public class UserAction extends ActionSupport{ 


public string add(){ // 添 加 用 户 
return SUCCESS; 
} 


public String delete(){ // 删 除 用 户 
return SUCCESS; 


public String update(){ // 修 改 用 户 
return SUCCESS; 
} 


public string find(){ // 查 找 用 户 
return SUCCESS; 
} 
} 


(2) 在 struts.xml 文件 中 添加 UserAction 的 配置 ， 总 共有 三 种 配置 方案 ， 不 过 ， 本 案例 中 
使 用 的 是 第 二 种 方案 ， 代 码 如 下 所 示 。 
<package name="HelloWord" extends="struts-default"> 
<!-- 第 一 种 : 通常 的 配置 方式 
<action name="user" class="com.cqxs.action.UserAction" method="add"> 
<result>/User add success.jsp</result> 
</action>--> 


<@— 
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<!-- 第 二 种 : 简化 配置 --> 

<action name="User *" class="com.cqxs.action.UserAction" method="{1}"> 
<result>/User {1} success.jsp</result> 

</action> 
<!-- ”第 三 种 : 使 用 通配符 最 大 限度 的 简化 配置 

<action name="* *" class="com.cqxs.action.{1}Action"> 
<result>/{1} {2} success.jsp</result> 

</action> =-> 

</package> 


(3) 在 项 目 根 目录 下 新 建 一 个 userjsp 页 面 ， 在 这 个 页 面 中 显示 用 户 的 信息 ， 并 可 以 通过 


单 击 链接 执行 “ 增 ”、“ 删 ”、“ 查 ”、“ 改 ”操作 ， 代 码 如 下 所 示 。 


<table align="center" style="color:#000000"> 
<thead><tr ><td> 用 户 名 </td><td> 密 码 </td><td> 年 龄 </td><td> 性 别 
</td></tr></thead> 
<tbody> 
<tr><td>sky</td><td>123456</td><td>23</td><td> 女 </td></tr> 
<tr><td>blue</td><td>lbule</td><td>28</td><td> 男 </td></tr> 
<tr><td> 雨 后 彩虹 </td><td>type</td><td>45</td><td> 男 </td></tr> 
<tr><tq> 小 河 </td><td>123</td><td>15</td><td> 女 </td></tr> 
<tr> 
<td><a href="User add.action"> 添 加 用 户 。</a></td> 
<td><a href="User delete.action"> 删 除 用 户 </a></td> 
<td><a href="User update.action"> 修 改 用 户 </a></td> 
<td><a href="User find.action"> 查 询 用 户 </a></td> 
</tr> 
</tbody> 
</table> 


(4) 当 单 击 “ 添 加 用 户 ” 链 接 发 出 “User_add.action ”请求 成 功 时 ， 将 跳 转 到 添加 用 户 成 


功 页 面 User_add_success.jsp， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 

<head></head> 

<body> 

用 户 : 添加 成 功 <br> 

</body> 

</html> 


(5) “删除 用 户 ” 成 功 页面 User_delete_success.jsp 的 代码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 

<head> 

<title> 删 除 用 户 成 功 </title> 

</head> 

<body> 

用 户 : 删除 成 功 <br> 
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</body> 
</html> 


(6) “查找 用 户 ” 成 功 页 面 User_find_success.jsp 的 代码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>My JSP '‘'success.jsp' starting page</title> 
</head> 
<body> 
用 户 : 查找 成 功 <br> 
</body> 
</html> 


(7) “修改 用 户 ” 成 功 页面 User_update_success.jsp 的 代码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"$%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>My JSP 'success.jsp' starting page</title> 
</head> 
<body> 
用 户 : 修改 成 功 <br> 
</body> 
</html> 


2-5 ”管理 用 户 
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2.3.5 ”实例 分 析 


a 


上 述 案 例 中 对 用 户 进行 了 “ 增 、 删 、 查 、 改 ”4 个 操作 ， 这 4 个 操作 也 就 对 应 了 4 个 请 求 。 
以 前 编写 Action 时 ， 一 个 请 求 操作 对 应 一 个 Action。 但 是 这 样 会 导致 struts.xml 文件 中 配置 的 
Action 急剧 增多 ， 不 便于 管理 ， 而 且 后 期 维护 修改 工作 量 也 会 大 量 增多 。 

因此 本 案例 采用 了 Action 的 通配符 配置 , 定义 了 一 个 UserAction， 将 对 用 户 的 一 切 操作 定 
义 成 不 同 的 方法 ， 如 : add、delete、update、select 方法 。 同时 在 struts.xml 文件 中 使 用 通配符 
配置 一 个 Action， 就 可 以 对 应 处 理 多 个 请 求 ， 这 样 Action 也 轻巧 多 了 。 


Action 的 配置 很 重要 ， 不 过 Result 配置 也 是 相当 重要 的 。 没 有 Result 配置 ， 程 序 就 没有 执 
行 结果 ，Result 配置 不 当 或 错误 ， 程 序 也 会 执行 出 错 的 结果 。 所 以 对 于 Result 的 配置 读者 要 认 
真 学 习 ， 以 达到 理解 并 灵活 应 用 的 程度 。 


A9 
视频 教学 ， 光盘 /videos/02/result.avi 长 度 : 7 分 钟 


2.4.1 基础 知识 Result 配置 


在 前 面 的 许多 案例 中 ， 所 用 到 的 Action 基本 都 继承 自 ActionSupport 这 个 类 。 这 个 类 中 定 
义 了 五 个 字段 : SUCCESS，NONE，ERROR，INPUT，LOGING。 我 们 可 以 直接 返回 这 些 字 段 
值 ， 这 些 字 段 值 的 实质 是 被 定义 成 : String SUCCESS="success" 的 形式 ， 所 以 只 要 在 Result 元 
素 中 用 它们 的 小 写 即 可 。 

<result> 标 准 完整 形式 如 下 。 

<result name="success" type="dispatcher"> 


<param name="location">/default .jsp</param> 
</result> 


如 果 都 采用 默认 的 形式 ， 最 终 可 以 简写 成 如 下 形式 。 
<result>/default.jsp</result> 


下 面 是 Result 类 型 列表 ， 共 同 认识 一 下 ， 如 表 2-4 所 示 。 


m= >> 
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表 2-4 Result 类 型 


type 类 型 什 作用 说 明 对 应 类 

chain 用 来 处 理 Action 链 com_.opensymphony.xwork2.ActionChainResult 
dispatcher 用 来 转向 页 面 ， 通 常 处 理 JSP | org.apache.struts2.dispatcher.ServletDispatcherResult 
Tedirect 重 定向 到 一 个 URL org.apache.struts2.dispatcher. ServletRedirectResult 
TedirectAction ”| 重 定向 到 一 个 Action org.apache.struts2.dispatcher. ServletActionRedirectResult 
plainText 显示 源 文件 内 容 ， 如 文件 源码 | org.apache.struts2.dispatcher.PlainTextResult 
freemarker 处 理 freemarker 模板 org.apache.struts2.views.freemarker.FreemarkerResult 
httpheader 控制 特殊 http 行为 的 结果 类 型 | Org.apache.struts2.dispatcher.HttpHeaderResult 

向 浏览 器 发 送 InputStream 对 
stream 象 ， 通 常用 来 处 理 文件 下 载 ， org.apache.struts2.dispatcher.StreamResult 

还 可 用 于 返回 Ajax 数据 
velocity 处 理 Velocity 模板 org.apache.struts2.dispatcher. VelocityResult 
Xslt 处 理 XML/XLST 模板 org.apache.struts2.views.xslt.XSLTResult 


Result 类 型 很 多 ， 不 过 常用 的 也 没 几 个 ， 在 此 将 挑选 几 个 常用 的 类 型 进行 详细 讲解 
1. dispatcher 

dispatcher 为 默认 的 result 类 型 ， 一 般 情况 下 在 struts.xml 中 会 写 出 如 下 代码 。 
<result name="success">/main.jsp</result> 

以 上 写法 使 用 了 两 个 默认 ， 其 完整 的 写法 如 下 所 示 。 


<result name="success" type="dispatcher"> 
<param name="location">/maini.jsp</param> 
</result> 


第 一 个 默认 : type="dispatcher"; 第 二 个 默认 : 设置 的 为 location 参数 ，location 只 
面 ， 不 能 是 另 一 个 Action( 可 用 type="chain" 解 决 )。 

2. redirect 

redirect 可 以 重 定向 到 一 个 页 面 ， 另 一 个 Action 或 一 个 网 址 。 


<result name="success" type="redirect">aaa.jsp</result> 
<result nam success" type="redirect">bbb.action</result> 
<result name="success" type="redirect">www.baidu.com</result> 


3. chain 
chain 主要 用 于 把 相关 的 几 个 Action 连接 起 来 ， 共 同 完成 一 个 功能 。 


<action name="stepl" class="test.SteplAction"> 

<result name="success" type="chain">step2.action</result> 
</action> 
<action name="step2" class="test.Step2Action"> 


能 是 页 


< 
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<result name="success">finish.jsp</result> 
</action> 


查看 execute0 方 法 ， 主 要 思想 如 下 。 


// 根据 Action 名 称 finalActionName 及 要 调用 的 方法 finalMethodName 来 new 一 个 代理 对 象 
proxy， 并 执行 之 

proxy =actionPproxyFactory.createActionPproxy (finalNamespace, finalActionName, 
finalMethodName, 

extraContext); 

proxy.execute (); 


多 个 Action 间 数 据 的 传递 ， 主 要 有 两 种 方式 。 

@ ”由 于 处 于 chain 中 的 Action 属于 同一 个 HTTP 请求， 共享 一 个 ActionContext， 故 可 以 
在 上 下 文中 获取 ， 在 页 面 上 可 以 直接 使 用 。 手 动 获取 的 方法 如 下 。 
HttpServletRequest request = ServletActionContext.getRequest (); 

String s=(String)request .getAttribute ("propName"); 
@ ”实现 ModelDriven 接口 ， 在 SteplAction 中 加 入 getModel， 代 码 如 下 所 示 。 


public Object getModel() { 
return message; 


E 
在 Step2Action 中 加 入 setModel， 代 码 如 下 所 示 。 


public void setModel (Object o){ 
System.out .println("message is:"+0o); 


} 


© fF setModel 的 调用 先 于 execute() 方 法 后 于 构造 方法 。 


2.4.2 ”实例 描述 


前 天 有 个 新 来 的 同事 问 了 我 一 个 问题 一 一 Result 只 能 配置 跳 转 到 JSP 页 面 吗 ? 答案 当然 是 


“否定 ”的 。 只 是 在 Result 的 配置 默认 情况 下 是 指定 跳 转 到 JSP 页 面 ， 因 此 我 们 也 可 以 配置 重 
定向 到 一 个 URL 或 重 定向 到 一 个 Action 等 。 下 面 将 通过 实例 来 看 看 如 何 配 置 重 定向 到 一 个 


Action。 


2.4.3 ”实例 应 用 


【 例 2-4】 部 门 信息 管理 。 


(1) 新 建 一 个 Struts 2 App 项 目 ， 在 该 项 目的 src 目录 下 新 建 一 个 struts.org.db 包 ， 然 后 在 


该 包 下 新 建 一 个 Deptjava， 最 后 封装 一 个 部 门 实体 类 ， 代 码 如 下 所 示 。 


m= >> 
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public class Dept implements Serializable { 


Private int deptId; // 部 门 Ia 
private String deptName; // 部 门 名 称 
private int deptNum; // 部 门 编号 
private String deptDesc; // 部 门 简介 
public Dept() { // 构 造 函数 


// TODO Auto-generated constructor stub 


public Dept (int deptId, String deptName, int deptNum, String deptDesc) { 
// 带 参 构造 

super (); 

this.deptId = deptId; 

this.deptName = deptName; 

this.deptNum = deptNum; 

this.deptDesc = deptDesc; 


public int getDeptId() { 
return deptId; 

} 

public void setDeptId(int deptId) { 
this.deptId = deptId; 


' 
// 下 面 是 deptNum、deptName 和 deptDesc 三 个 属性 的 get、set 方法 ， 在 此 省 略 
} 


(2) 对 部 门 信息 进行 添加 、 删 除 、 查 看 和 修改 4 个 操作 。 因 为 
封装 一 个 操作 数据 库 类 Testjava， 代 码 如 下 所 示 。 


public class Test { 

private String username="root"; // 数 据 库 用 户 名 

private String password="123456"; // 数 据 库 密码 

private String 
url="jdbc:mysql://localhost:3309/dept?useUnicode=truegcharacterEncoding=utf 
8"; 

private String driver="com.mysql.jdbc.Driver"; //mysql 驱动 类 

public Test() { 


;要 连接 数据 库 ， 所 以 需要 


public Connection getConnection ()throws Exception{ 


Class.forName (driver); // 加 载 mysql 驱动 

Connection conn = DriverManager.getConnection (url, username,password); 
// 获 取 数 据 库 连接 对 象 conn 
return conn; // 返 回 连接 对 象 conn 


} 
public Statement getStatement (){ 
Statement st = null; 


// 声 明 一 个 Statement 对 象 ， 用 于 执行 静态 SQL 语句 并 返回 它 所 生成 结果 的 对 象 
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st = getConnection () .createStatement (); // 获 取 Statement 对 象 实例 
} catch (SOLException e) { 

e.printStackTrace (); 


} catch (Exception e) { 
e.printstackTrace (); 
return st; // 返 回 statement 对 象 st 
} 
public List getDepts (){ // 获 取 部 门 信息 列表 
List<Dept> list = new ArrayList<Dept>(); 


// 创 建 一 个 存储 部 门 信息 的 列表 对 和 象 1ist 


tryt{ 
String sql="select * from dept"; // 查 询 sql 语句 
ResultSet rs=getStatement () .executeQuery (sq1); 
// 执 行 查询 sql 语句 ， 返 回 结果 集 rs 
while(rs.next ()){ 
Dept dept = new Dept(); // 创 建 一 个 部 门 对 象 
int deptid = rs.getInt ("deptid");  // 获 取 结 果 集 中 deptid 的 值 
String deptName=rs.getString ("deptname"); 
int deptnum = rs.getInt ("deptnum"); 
String deptDesc =rs.getString("deptdesc"); 
dept .setDeptId (deptid); 
// 将 从 结果 集中 获取 的 deptiad 赋 给 部 门 对 象 的 deptiad 属 性 
dept .setdeptName (deptName); 
dept .setDeptNum (deptnum); 
dept .setDeptDesc (deptDesc); 
list.adqd (dept); // 将 dept 添加 到 1ist 列表 中 


rs.close() // 关 闭 rs 
getStatement () .close() // 关 闭 st 
getConnection() .close() // 关 闭 conn 


}catch (Exception e){ 
e.printstackTrace (); 


} 


return list; // 返 回 查询 到 的 部 门 信息 列表 对 象 
Public int getMaxId(){ // 获 取 最 大 的 部 门 编号 

int max=0; 

tryt{ 


String sql="select max (deptid) from dept"; 

ResultSet rs=getStatement () .executeQuery (sql); // 查 找 最 大 的 部 门 编号 

while(rs.next()){ 
int deptid=rs.getInt (1); // 获 取 最 大 的 部 门 编号 
max=deptid+1; // 最 大 的 部 门 编号 再 加 1 

了 

rs.close(); 

getStatement () .close(); 
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getConnection () .close(); 
} catch (Exception e){ 
e.printstackTrace () 
} 
return max; // 返 回 max 值 
} 
public void insertDept (String deptName,int deptNum, String deptDesc){ 
// 添 加 一 个 新 部 门 
int deptId=getMaxId(); 
// 将 目前 最 大 的 部 门 编号 再 加 1， 就 得 到 了 添加 新 部 门 的 deptId 
try{ 
String sql="insert into dept (deptId,deptName,deptNum, deptDesc) 
values ("+deptId+", '"+deptName+"', "+deptNum+", '"+deptDesct"')"; 
// 添 加 了 一 个 新 部 门 的 信息 语句 
getStatement () .executeUpdate (sql) ; // 执 行 添加 新 部 门 的 sql 语句 
getStatement () .close(); 
getConnection() .close(); 
}catch (Exception e){ 
e.printstackTrace (); 


} 
public Dept prepareUpdateDept (int deptId){ // 通 过 deptId 查找 部 门 
Dept dept = new Dept(); 
tryt{ 
String sql="select * from dept where deptid="+deptId; 
// 查 找 deptIq 部 门 信息 的 sql 语句 
ResultSet rs=getStatement () .executeQuery (sql); // 执 行 查找 sql 语句 
while(rs.next()){ 
dept .setDeptId(rs.getInt ("deptid")); 
// 将 结果 集中 deptid 的 值 赋 给 dept 的 deptId 属性 
dept .setdeptName (rs.getSstring ("deptname")); 
dept .setDeptNum(rs.getInt ("deptnum")); 
dept .setDeptDesc(rs.getSstring ("deptdesc")); 
; 
rs.close(); 
getStatement () .close (); 
getConnection() .close(); 
}catch (Exception e){ 
e.printstackTrace (); 


} 


return dept; // 返 回 查 找到 的 部 门 对 象 
} 
public void updateDept (int deptId, String deptName,int deptNum,String 
deptDesc){ 
tryt{ 


String sql="update dept set 
deptname='"+deptName+"', deptnum="+deptNum+", deptdesc='"+deptDesc+"' where 
deptid="+deptId; 
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getStatement () .executeUpdate (sql) ; // 执 行 sql 
getStatement () -close() 
getConnection() .close(); 
}catch (Exception e){ 
e.printstackTrace (); 


} 
public void deleteDept (int deptId){ // 删 除 编号 为 deptId 的 部 门 信息 记录 
tryt{ 
String sql="delete from dept where deptid="+deptId; 
/ /删除 编号 为 septId 部 门 信息 记录 的 sql 语句 
getStatement () .execute (sql); // 执 行 sql 语句 
getStatement () .close (); 
getConnection() .close(); 
}catch (Exception e){ 
e.printstackTrace (); 


} 


} 


(3) 封装 定义 DeptAction， 这 个 Action 包含 对 应 的 “添加 ”、“ 删 除 ”、“ 修 改 ” 和 “ 查 
看 ”四 个 操作 的 请 求 方法 ， 代 码 如 下 所 示 。 


public class DeptAction extends ActionSupport { 


public DeptAction() { 
// TODO Auto-generated constructor stub 
} 
public String selectDept() { // 查 询 部 门 信息 
HttpServletRequest request=ServletActionContext .getRequest (); 
Test test = new Test(); // 创 建 一 个 Test 类 对 象 
List depts=test.getDepts(); 
// 调 用 getDepts () 方 法 返回 得 到 部 门 信息 列表 
depts 
request .setAttribute ("depts", depts); // 将 该 列表 对 象 存 入 request 对 象 中 
return "success"; // 返 回 请 求 成 功 
} 
public String insertDept() throws UnsupportedEncodingException{ 
// 添 加 部 门 
Test test = new Test(); 创建 一 个 Test 类 对 象 
HttpServletRequest request=ServletActionContext .getRequest (); 


//request 对 象 
String deptName=request .getParameter ("deptName"); // 获 取 部 门 名 称 
int deptNum = Integer.valueOf (request.getParameter ("deptNum")); 

// 获 取 部 门 编号 


String deptDesc = request.getParameter ("deptDesc"); // 获 取 部 门 简介 
test.insertDept (deptName, deptNum, deptDesc); 

// 调 用 insertDept () 方 法 添加 部 门 
return "success"; // 返 回 请 求 操作 成 功 


} 
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public String prepareUpdate(){ // 得 到 部 门 Id 为 deptId 的 部 门 对 象 


} 


Test test = new Test(); 

HttpServletRequest request=ServletActionContext .getRequest (); 
int deptId=Integer.valueOf (request .getParameter ("id")); 

Dept dept=test.prepareUpdateDept (deptId); 

request .setAttribute ("dept", dept); 

return "success"; 


public String updateDept (){ // 修 改 部 门 信息 


Test test = new Test(); 
HttpServletRequest request=ServletActionContext .getRequest (); 
// 获 取 request 对 象 
int deptId=Integer.valueOf (request .getParameter ("#request .dept .deptId")); 
// 从 request 对象 中 取出 部 门 Id 
String deptName=request.getParameter ("#Iequest.dept.deptName") 7 
// 从 request 对 象 中 取出 部 门 名 称 
int deptNum = Integer.valueOf (request .getParameter 
("#request .dept .deptNum")); 
// 从 request 对 象 中 取出 部 门 编号 
String deptDesc = request.getParameter ("#request.dept.deptDesc"); 
// 从 request 对 象 中 取出 部 门 描述 
test.updateDept (deptId, deptName, deptNum, deptDesc); 


// 调 用 updateDept () 方 法 来 修改 部 门 信息 


return "success"; // 返 回 请 求 操作 成 功 
} 
public String deleteDept (){ // 删 除 一 个 部 门 信息 
Test test = new Test(); // 创 建 一 个 Test 类 对 象 
HttpServletRequest request=ServletActionContext .getRequest () 
// 获 取 request 对 象 


int deptId=Integer.valueOf (request.getParameter ("id")); 
// 从 request 对 象 中 取出 部 门 Id 
test.deleteDept (deptId) 
// 调 用 deleteDept () 方法 删除 部 门 Id 为 deptId 的 部 门 信息 
return "success"; // 返 回 请 求 操作 成 功 


(4) 在 项 目的 src 目录 下 新 建 一 个 struts.xml 文件 ， 在 该 文件 中 添加 DeptAction 的 配置 ， 
代码 如 下 所 示 。 


<struts> 
<include file="struts-default.xml"/> <!-- 引入 struts-default.xml 文件 --> 
<package name="struts2" extends="struts-default"> <!-- 创建 一 个 名 为 
struts2 的 包 --> 


<!-- 配置 一 个 名 为 selectDept 的 Action, 当 请 求 这 个 Action 时 执行 DeptAction 中 


的 selectDept 方法 查询 部 门 信息 --> 


<E@— 
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<action name="selectDept" class="struts.org.db.DeptAction" 
method="selectDept"> 
<result name="success">dept.jsp</result><!-- 查询 成 功 后 , 跳 转 到 
dept .jsp --> 
</action> 
<!-- 配置 一 个 名 为 insertDept 的 Action, 当 请 求 这 个 Action 时 执行 DeptAction 中 
的 insertDept 方法 查询 部 门 信息 --> 
<action name="insertDept" class="struts.org.db.DeptAction" 
method="insertDept"> 
<result name="success" type="redirect-action"><!-- 添加 成 功 后 , 重 定 
向 到 selectDept--> 
selectDept 
</result> 
</action> 
<!-- 配置 一 个 名 为 prepareUpdateDept 的 Action, 当 请 求 这 个 Action 时 执行 
DeptAction 中 的 prepareUpdate 方法 查询 部 门 信息 --> 
<action name="prepareUpdateDept" 
class="struts.org.db.DeptAction" method="prepareUpdate"> 
<result>updateDept .jsp</result><!-- 获取 要 修改 的 部 门 信息 成 功 后 , 跳 转 到 
updateDept.jsP --> 
</action> 
<!-- 配置 一 个 名 为 updateDept 的 Action, 当 请 求 这 个 Action 时 执行 DeptAction 中 
的 updateDept 方法 查询 部 门 信息 --> 
<action name="updateDept" class="struts.org.db.DeptAction" 
method="updateDept"> 
<result name="success" type="redirect-action"><!-- 修 改 部 门 信息 成 功 
后 , 重 定向 到 selectDept --> 
selectDept 
</result> 
</action> 
<!-- 配置 一 个 名 为 deleteDept 的 Action, 当 请 求 这 个 Action 时 执行 DeptAction 中 
的 deleteDept 方法 查询 部 门 信息 --> 
<action name="deleteDept" class="struts.org.db.DeptAction" 
method="deleteDept"> 
<result name="success" type="redirect-action"><!-- 删除 部 门 信息 成 功 
后 , 重 定向 到 selectDept --> 
selectDept 
</result> 
</action> 
</package> 
</struts> 


(5) 前 期 工作 都 做 好 后 ， 开 始 做 显示 操作 部 门 信息 的 页 面 。 在 Struts 2 App 项 目的 目录 下 


新 建 一 个 index.jsp 页 面 。 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@ taglib prefix="s" uri="/struts-tags" %> 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
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全 
<head> 
<title> 查 看 部 门 信息 </title> 
</head> 
<body> 
<s:form action="selectDept" method="post"> <!-- 创建 一 个 表单 , 提交 表 


单 发 出 selectDept (查询 部 门 信息 的 Action 请 求 ) --> 
<s:submit value=" 部 门 信息 "/> 
</s:form> 
</body> 
</html> 


(6) 新 建 一 个 deptjsp 页 
部 门 信息 的 操作 。 代 码 如 下 所 示 。 


<table align: 
<tr align="center"> 
<td> 部 门 名 称 </td><td> 部 门人 数 </td><td> 部 门 描述 </td><td> 操 作 </td> 
</tr> 
<s:iterator value="#request.depts" status="stuts"> <!-- 迭代 显示 当前 所 有 部 
门 信息 --> 
<tr> 
<td><s:property value="deptName"/></td> 
<td><s:property value="deptNum"/></td> 
<td><s:property value="deptDesc"/></td> 
<td align="center"> 
<!-- 添加 修改 当前 行 所 代表 的 部 门 信息 链接 --> 
<a href="prepareUpdateDept .action?id=<s:property 
value='deptId'/>"> 修 改 </a> 
<!-- 添加 删除 当前 行 所 代表 的 部 门 信息 链接 --> 


<a href="deleteDept .action?id=<s:property value='deptId'/>"> 


用 于 显示 部 门 信息 ， 及 执行 “添加 ”、“ 修 改 ” 和 “删除 ” 


"center" width="70%" cellspacing="0" cellpadding="0" border=1> 


删除 </a> 
</td> 
</tr> 
</s:iterator> 
<tr> 
<!-- 添加 新 增 部 门 信息 链接 --> 
<td colspan=8><a href="<s:url value="/deptNew.jsp"/>"> 新 增 </a></td> 
</tr> 
</table> 


(7) 新 建 一 个 修改 部 门 信息 的 updateDeptjsp 页 面 ， 代 码 如 下 所 示 。 


<s:form action="updateDept" method="post"> 
<s:textfield name="#request .dept .deptId" label=" 部 门 Id" readonly="true"/> 
<s:textfield name="#request .dept .deptName" label=" 部 门 名 称 "/> 
<s:textfield name="#request .dept .deptNum"” label=" 部 门 编号 "/> 
<s:textarea name="#request.dept.deptDesc" rows="5" cols="20" label=" 部 门 
简介 "></s:textarea> 
<s:submit value=" 提 交 "></s:submit> 
</s:form> 


<E@—— 
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(8) 新 建 一 个 添加 部 门 信息 的 deptNew.jsp 页 面 ， 代 码 如 下 所 示 。 


<s:form action="insertDept" method="post"> 
<s:textfield name="deptName" label=" 部 门 名 称 "/> 
<s:textfield name="deptNum” label=" 部 门 编号 "/> 
<s:textarea name="deptDesc" rows="5" cols="20" label=" 部 门 简介 "/> 
<s:submit value=" 添 加 "></s:submit> 
<s:reset value=" 重 置 "></s:reset> 
</s:form> 


2.4.4 运行 结果 


打开 正 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2App/index.jsp”， 访 问 查看 
部 门 信息 页 面 ， 执 行 效 果 如 图 2-6 所 示 。 


PE 


理 看 部 门下 


图 2-6 部 门 信息 管理 


单 击 查看 部 门 信息 页 面 中 的 “部 门 信息 ”按钮 ， 即 可 查看 当前 所 有 部 门 的 信息 ， 还 可 以 执 
行 “ 添 加 ”、“ 修 改 ” 和 “删除 ”部 门 操作 。 执 行 效果 如 图 2-7 所 示 。 


2-7 ”部 门 信息 管理 
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单 击 “ 新 增 ” 链 接 ， 进 入 添加 部 门 信息 页 面 ， 从 中 可 以 输入 新 部 门 的 信息 ， 单 击 “ 添 加 ” 
按钮 ， 添 加 成 功 后 ， 执 行 效果 如 图 2-8 所 示 。 


图 2-8 添加 部 门 信息 
“修改 ”和 “删除 ”操作 读者 可 以 在 做 练习 实例 时 执行 查看 效果 ， 在 此 不 再 详解 。 


2.4.5 “实例 分 析 


让 sn 


本 案例 是 对 部 门 信息 的 管理 ， 所 以 首先 封装 出 一 个 部 门 实 体 类 Deptjava， 包 含 部 门 Id、 名 


称 、 编 号 等 。 

然后 定义 一 个 部 门 DeptActionp， 用 于 接收 处 理 对 部 门 信息 的 “ 增 、 删 、 查 、 改 ”操作 的 请 
求 ， 而 且 在 struts.xml 文件 中 配置 了 DeptAction 。 

最 后 创建 一 个 前 台 操作 页 面 ， 如 : 查看 部 门 信息 页 面 (indexjsp)、 部 门 信息 管理 页 面 
(dept.jsp)、 添 加 部 门 信息 页 面 (deptNew.jsp)、 修 改 部 门 信息 页 面 (updateDept.jsp)。 


2.5 用 户 注册 动态 配置 Result 


什么 是 动态 配置 Result? 动态 就 是 有 不 确定 因素 ， 也 就 是 说 只 有 在 执行 的 时 候 才 能 知道 
Result。 本 节 将 详细 介绍 Stmuts 2 是 如 何 动态 配置 Result 的 。 


s 
E> 视频 教学 ， 光盘 /videos/02/ dongtai_result_1.avi 人 @@ 长 度 : 7 分 名 
光盘 /videos/02/ dongtai result_ 2.avi 四 长 度 : 9 分 钟 
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HBs 人 Web 开发 学 习 实录 .六 


2.5.1 基础 知识 动态 配置 Result 


给 大 家 举 个 例子 ， 请 读者 想象 一 下 状态 机 一 样 的 执行 流 ， 下 一 个 状态 依赖 于 输入 元 素 、 
session 属性 、 用 户 角色 等 的 组 合 。 换 句 话 说， 判定 下 一 个 Action、 输 入 和 其 他 什么 内 容 ， 这 些 
在 配置 的 时 候 是 难以 知晓 的 。 

就 像 Struts 2 中 的 标签 库 ， 通 过 使 用 EL 表达 式 可 以 访问 Action 属性 ， 也 可 以 使 用 相应 的 
方式 访问 Result 的 值 。 下 面 是 FragmentAction 的 实现 代码 。 

import com.opensymphony.xwork2.RActionSupPort7 

public class FragmentAction extends ActionSupport{ 


private String nextAction; 
public String getNextAction() { 
return nextAction; 
1 
} 


可 能 会 定义 一 个 Result， 配 置 如 下 所 示 。 
<action name="fragment" class="FragmentAction"> 


<result name="next" type="redirectAction">${nextAction}</result> 


</action> 


如 果 FragmentAction 返回 的 Result 与 nextAction 属性 的 实际 值 相同 。 那 么 ，nextAction 将 
把 结果 传递 给 下 一 个 redirectAction 。 


2.5.2 ”实例 描述 


Action 配置 结果 都 是 在 配置 文件 中 显现 静态 的 , 那么 有 没有 可 以 动态 配置 Result 的 呢 ? 当 
然 有 有 了， 本 节 将 通过 用 户 注册 来 动态 地 配置 Result。 


2.5.3 ”实例 应 用 


【 例 2-5】 用 户 注册 动态 配置 Result。 
(1) 先 在 项 目 目录 下 创建 一 个 用 户 注册 页 面 registerjsp, 页 面 主要 包含 一 个 用 户 注册 表单 ， 
需 填 入 用 户 名 、 密 码 、 性 别 信息 ， 单 击 “ 现 在 注册 ”按钮 即 可 注册 。 主 要 代码 如 下 所 示 。 


<FORM action="user!add" method="post" > 

<DIV class=logbox> 

<H1> 您 还 没有 注册 !</H1> 

<UL> 
<LI> 用 户 名 snbsp; gnbsp; 

<INPUT type="text" name="userName"> 

</LI> 
<LI> 密 gnbsp; gnbsp; &nbsp; &nbsp; 码 gnbsp; gnbsp; 
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<INPUT type=password name="password"> 
</LI> 
<LI> 性 gnbsp; snbsp; gnbsp; gnbsp; 别 gnbsp; gnbsp; 
<INPUT type="text" name="sex"> 
</LI> 
<DIV align=center><A style="COLOR: red" href=""> 我 要 登录 


</A>&gnbsp; gnbsp; gnbsp; gnbsp; Enbsp; &nbsp; Enbsp; gnbsp; gnbsp; Enbsp; tnbsp; & 
nbsp; 
<A class=numlink href=""> 找 回 密码 ! </A> 
</DIV> 
<DIV class=clear></DIV></LI></UL></DIV><!-- 登 录 --> 
<DIV class=1lt id=jinru> 
<INPUT id=url type=hidden value=http://blogs.bokee.com/ name=url> 
<INPUT class=logbtn type=submit value= 现 在 注册 name=submit> 
</DIV> 
<DIV class=clear> 
</DIV> 
</DIV> 
</FORM> 


(2) 创建 一 个 用 户 注册 RegisterAction， 用 来 处 理 用 户 注册 操作 ， 代 码 如 下 所 示 。 


package cn.edu.ahau.mgc.struts2.action; 
import com.opensymphony .xwork2.ActionSsupport; 
public class RegisterAction extends ActionSupport { 


private String userName; 

private String password; 

private String url; 

private String sex; 

public String getUserName() { 
return this.userName; 


1 


public void setUserName (String userName) { 
this.userName = userName; 
} 
// 下 面 是 和 上 面 getUserName () 、setUserName () 方 法 一 样 的 用 来 获取 和 设置 密码 、 
// 性 别 、url 的 get、set 方法 
public String add() 1{ 
if (userName == null || "".equals (userName)|| 
password ==null||"".equals (password)) { 
url = "/registerError.jsp"; 
} 
else { 
url = "/registerSuccess.jsp"; 
} 
return SUCCESS; 


<@— 
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} 
(3) 定义 好 RegisterAction 后 ， 在 struts.xml 文件 中 配置 这 个 Action， 代 码 如 下 所 示 。 


<constant name="struts.devMode" value="true" /> 


<constant name: 


struts.il8n.encoding" value="UTF-8"></constant> 


<package name="user" namespace="/" extends="struts-default"> 
<action name="user™" 
class="cn.edu.ahau.mgc.struts2.action.RegisterAction"> 
<result>${url}</result> 
</action> 
</package> 


(4) 创建 一 个 用 户 注册 成 功 提示 页 面 registerSuccess.jsp， 代 码 如 下 所 示 。 


<%@ page language="java" pageEncoding="UTF-8"%> 
<%@ taglib uri="/struts-tags" prefix="s" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>Dynamic</title> 
</head> 
<body> 
恭喜 您 ， 注 册 成 功 ! 
</body> 
</html> 


(5) 创建 一 个 用 户 注册 失败 提示 页 面 registerError.jsp， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@ taglib uri="/struts-tags" prefix="s" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>Dynamic</title> 
</head> 
<body> 
很 抱 菊 ， 您 注册 失败 ! 
</body> 
</html> 


2.5.4 ”运行 结果 


打开 一 个 浏览 器 页 面 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_2/register.jsp” 运 行 注 
册页 面 ， 效 果 如 图 2-9 所 示 。 


Eee > 
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和 


请 帮 式 词 。 差 立 震 窜 。 生活 体 驼 。 娱乐 中 必 


您 还 没有 注册 ! 


图 2-9 用 户 注册 动态 配置 Result 
当 用 户 输入 合法 信息 时 ， 单 击 “ 现 在 注册 ”按钮 ， 将 会 跳 转 到 registerSuccess.jsp 页 面 ， 
不 合法 ， 将 跳 转 到 registerErrorjsp 页 面 。 由 于 这 两 个 提示 页 面 比较 简单 ， 在 此 执行 效果 图 不 再 


2.5.5 ”实例 分 析 


a 


上 述 实例 首先 给 出 了 一 个 用 户 注册 页 面 ， 主要 包含 一 个 用 户 输入 用 户 名 、 密 码 、 性 别 等 注 
册 信 息 的 表单 ， 但 用 户 输 入 信息 完毕 单 击 “ 现 在 注册 ”按钮 后 ， 将 会 把 表单 信息 提交 给 
RegisterAction。 这 个 Action 中 包含 了 一 个 特别 重要 的 属性 “url”, 这 个 属性 就 是 配置 动态 Result 
时 要 使 用 的 ， 当 判断 用 户 输入 的 信息 合法 时 ， 将 这 个 属性 赋值 为 “registerSuccess.jsp” ， 不 合 
法 时 , 将 这 个 属性 赋值 为 “registerError.jsp”, 在 struts.xml 文件 中 采用 <result> 标 签 配置 该 Action 
的 跳 转 结果 时 ， 应 这 样 配置 <result>$ {url}</result>。 


2.6 登录 异常 处 理 
任何 成 熟 的 MVC 框架 都 应 该 提供 成 功 的 异常 处 理 机 制 。Stmut 2 也 不 例外 。Struts 2 提供 了 
一 种 声明 式 的 异常 处 理 方式 ， 它 是 通过 配置 拦截 器 来 实现 异常 处 理 机 制 的 。 
Fs 视频 教学 : 光盘 /videos/02/exception.avi 人 @@ 长 度 : 7 分 名 
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2.6.1 基础 知识 


Struts 2 的 异常 机 制 


Stmts 2 的 异常 处 理 机 制 通过 在 struts.xml 文件 中 配置 <exception-mapping...> 元 素 完 成 ， 配 
置 该 元 素 时 ， 需 要 指定 两 个 属性 。 

@ ”exception: 此 属性 指定 该 异常 映射 所 设置 的 异常 类 型 。 

@ result: 此 属性 指定 Action 出 现 该 异常 时 ， 系 统 转 入 Result 属性 所 指向 的 结果 。 

异常 映射 也 分 为 两 种 。 

@ 局 部 异常 映射 : <exception-mapping...> 元 素 作为 <action...> 元 素 的 子 元 素 配 置 。 

@ 全 局 异常 映射 : <exception-mapping...> 元 素 作为 <global-exception-mappings> 元 素 的 子 

元 素 配 置 。 

输出 异常 使 用 Struts 2 的 <s:property> 标 签 来 实现 ， 代 码 如 下 所 示 。 

<s:property value="exception.message"/> <!-- 输出 异常 对 象 本 身 --> 

<s:property Value="exceptionStack"/> <!-- 输 出 异常 堆栈 信息 --> 


2.6.2 ”实例 描述 


相信 学 习 编程 的 人 对 异常 处 理 都 不 陌生 ， 从 刚 开 始 学 习 Java 编程 语言 时 ， 就 已 经 开始 学 
习 异 常 处 理 了 , 因为 这 是 编程 必用 的 知识 。 只 有 熟悉 灵活 地 处 理 异常 , 才能 使 程序 更 加 的 完善 ， 
使 用 户 使 用 起 来 也 更 加 的 得 心 应 手 。 记 得 刚 开始 学 习 Java 语言 时 ， 要 求 写 个 程序 进行 除法 运 
算 。 由 于 当时 还 没 学 到 异常 处 理 ， 当 输入 除数 为 0 时 ， 虚 拟 机 发 出 异常 了 ， 程 序 就 死 那儿 了 。 

所 以 程序 当中 的 异常 处 理 是 非常 重要 的 ， 本 节 通 过 处 理 用 户 登 录 异 常 ， 来 演示 Struts 2 的 
异常 处 理 机 制 。 


2.6.3 ”实例 应 用 


【 例 2-6】 登录 异常 处 理 。 
(1) 在 项 目 Struts2 2 的 src 目录 下 ， 新 建 一 个 lee 包 ， 在 该 包 下 新 建 一 个 LoginAction， 用 
来 处 理 用 户 的 登录 请 求 ， 代 码 如 下 所 示 。 


package lee; 
import com.opensymphony .xwork2.Action; 
Public class LoginAction implements Action 
{ 

private String username; 

private String password; 

private String tip; 


// 下 面 是 username、password、tip 几 个 属性 的 get、set 方法 ， 在 此 省 略 
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Public String execute () throws Exception 
if (getUsername () .equalsIgnoreCase ("user")) 
throw new MyException(" 自 定义 异常 "); 
if (getUsername () .equalsIgnoreCase ("sql")) 
throw new java.sql.SQLException ("用户 名 不 能 为 SQL"); 
if (getUsername () .equals ("scott") && getPassword() .equals ("tiger") ) 


setTip ("哈哈 ,服务 器 提示 ! "); 
return SUCCESS; 

} 

else 

{ 
return ERROR; 


} 
(2) LoginAction 定义 好 后 ， 在 struts.xml 文件 中 对 其 进行 配置 ， 代 码 如 下 所 示 。 
<package name="mypackage" extends="struts-default"> 
<!-- 此 处 定义 所 有 的 全 局 结果 --> 
<global-results> 
<result name="sql">/exception.jsp</result> 
<result name="root">/exception.jsp</result> 
</global-results> 
<!-- 此 处 定义 全 局 异常 映射 --> 
<global-exception-mappings> 
<!-- Action 抛 出 SQLException 异常 时 , 转 入 名 为 sql 的 结果 --> 
<exception-mapping result="sqgl" 
exception="java.sql.SQLException"> 
</exception-mapping> 
<exception-mapping result="root™ 
exception="java.lang.Exception"> 
</exception-mapping> 
</global-exception-mappings> 
<action name="login" class="]lee.LoginAction"> 
<!-- 下 面 配置 一 个 局 部 异常 映射 , 当 Action 抛 出 lee .MyException 时 , 转 入 名 为 my 的 
结果 --> 
<exception-mapping result="my" 
exception="lee.MyException"> 
</exception-mapping> 
<!-- 下 面 定义 结果 --> 
<result name="my">/exception.jsp</result> 
<result name="success">/welcome.jsp</result> 
<result name="error">/error.jsp</result> 


<E@—— 


ts 2Q web 开发 学 习 实录 


</action> 
</package> 
(3) 定义 一 个 异常 类 MyException.java， 代 码 如 下 所 示 。 


package lee; 


public class MyException extends Exception 
{ 

public MyException(){} 

public MyException (String msg) 

{ 


super (msg); 
} 
(4) 在 项 目 目录 下 新 建 一 个 login_ejsp 页 面 ， 页 面 中 定义 一 个 form 表单 ， 包 含 两 个 输入 


文本 框 和 一 个 按钮 ,用 户 可 以 输入 用 户 名 与 密码 , 单 击 “ 登 录 ” 按 钮 进行 登录 。 代 码 如 下 所 示 。 


<%@ page language="java" contentType="text/html; charset=GBK"%®> 
<html> 
<head><title> 登 录 页 面 </title></head> 
<body> 
<h2 class="mem"><span> 会 员 登 录 </span></h2> 
<form id="login" method="post" action="login.action"> 
<div> 
请 输入 用 户 名 : 
<input type="text" name="username" value="" class="txtBox" /> 
请 输入 密码 : 
<input type="password" name="password" value="" class="txtBox" /> 
</div> 
<div id="foget"> 忘 记 密码 ? 
<input type="submit" name="login" value=" 登 录 " class="login" /> 
</div> 
</form> 
</body> 
</html> 


(5) 新 建 一 个 欢迎 页 面 welcome.jsp， 当 用 户 登 录 成 功 时 ， 跳 转 到 该 页 面 ， 代 码 如 下 所 示 。 


<%@ page language="java" contentType="text/html; charset=GBK"®> 
<%@taglib prefix="s" uri="/struts-tags"%®> 
<html> 
<head> 
<title> 成 功 页 面 </title> 
</head> 
<body> 
您 已 经 登录 ! 
<s:property value="model .tip"/> 
</body> 
</html> 
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(6) 当 用 户 登录 出 现 异 常 时 ， 需 要 处 理 异常 ， 所 以 需要 新 建 一 个 exception.jsp 页 面 ， 代 码 
如 下 所 示 。 


<%@ page language="java" contentType="text/html; charset=GBK"g%> 
<%@taglib prefix="s" uri="/struts-tags"%> 
<html> 
<head> 
<title> 异 常 处 理 页 面 </title> 
</head> 
<body> 
<s:property value=" exception.message"/> 
</body> 
</html> 


(7) 当 登 录 出 现 错误 时 ， 新 建 一 个 errorjsp 页 面 即 可 解决 ， 代 码 如 下 所 示 。 


<%@ page language="java" contentType="text/html; charset=GBK"%> 
<html> 

<head> 

<title> 错 误 页 面 </title> 

</head> 

<body> 

您 不 能 登录 ! 

</body> 

</html> 


2.6.4 运行 结果 


以 下 是 登录 异常 捕获 处 理 的 过 程 ， 运 行 结 果 如 图 2-10 所 示 。 当 用 户 单 击 “ 登 录 ” 按 钮 ， 
会 出 现 异 常 信息 ， 如 图 2-11 所 示 。 


Tends to your 


SUCCESS 


图 2-10 ”登录 异常 图 2-11 异常 处 理 
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2.6.5 ”实例 分 析 


a 


当 用 户 输入 不 合法 的 用 户 名 时 ， 会 出 现 登 录 异 常 。 通 过 <exception-mapping> 标 签 配置 一 个 
局 部 异常 映射 ， 当 Action 抛 出 lee MYException 时 ， 转 入 名 为 my 的 结果 。 使 用 <result 
Dame="my">/exception.jsp</result> 标 签 指 定 my 结果 , 跳 转 到 exception .jsp 页面 , 处 理 登 录 异 常 。 


2.7 常见 问题 解答 


2.7.1 Struts 2 配置 常见 异常 处 理 


Stmuts 2 配置 常见 异常 怎么 处 理 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10930-1-1.html 

各 位 前 辈 ， 我 初学 Struts 2， 有 很 多 都 不 是 很 明白 ， 就 比 萌 芦 画 断 做 了 一 个 例子 ， 我 使 用 
的 开发 环境 如 下 。 

JDK6+Tomcat6+Struts-2.1.6( 最 新 ) 

struts2 下 载 地 址 : http://struts.apache.org/ 


小 程序 用 到 jar 包 如 下 。 
struts2-core.jar, commons-logging.jar, freemarker.jar, ognl.jar, xwork.jar 
安装 实例 配置 好 以 后 ， 开 始 运 行 ， 可 是 出 现 以 下 错误 。 


严重 : Exception starting filter struts2 

Unable to load configuration. - bean 一 
jar:file:/E:/struts2/struts2/WebRoot/WEB-INF/1ib/struts2-core-2.1.6.jar! 
/struts-default .xml:46:178 


【解决 办 法 】 这 个 问题 不 是 什么 难 解决 的 问题 ， 只 是 你 不 知道 ， 在 Struts 2 的 org.apache. 
struts2.dispatcher.multipart 包 下， 有 个 JakartaMultiPartRequest 类 ， 它 需要 引入 下 面 如 下 几 个 类 。 


import org.apache.commons.fileupload.FileItem; 

import org.apache.commons.fileupload.FileUploadException; 
import org.apache.commons.fileupload.RequestContext; 

import org.apache.commons.fileupload.disk.DiskFileItem; 

import org.apache.commons.fileupload.disk.DiskFileItemFactory; 
import org.apache.commons.fileupload.servlet.ServletFileUpload; 


你 的 错误 就 是 你 没有 加 载 这 个 几 个 类 文件 包 ， 所 以 找 不 到 类 ， 只 要 把 commons- 
fileupload-1.2.1. jar 和 commons-io-1.3.2.jar 导入 ， 问 题 就 解决 了 。 
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2.7.2 HTTP Status 404 -在 Action 配置 中 没有 找到 相应 的 Action 
Name 怎么 办 


HTTP Status 404- 在 Action 配置 中 没有 找到 相应 的 Action Name 怎么 办 ? 
网 络 课堂 : http://bbs.itzcn.com/thread-10933-1-1.html 


控制 台 总 是 输出 如 下 错误 。 


HTTP Status 404 - There is no Action mapped for action name2010-03-05 15:37There 
is no Action mapped for namespace / and action name ... 


【解决 办 法 】 对 于 这 个 问题 确实 不 好 解决 ， 你 可 以 从 以 下 几 种 情况 入 手 解决 。 
(1) 首先 确认 struts.xml 文件 是 否 在 src 目录 下 。 很 多 时 候 struts.xml 放 在 WEB-INF 下 而 
不 是 放 在 classes 下 。 
(2) 检查 struts.xml 文件 的 语法 是 否 正确 。 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<include file="struts-default.xml"/> 
<package name="struts2" extends="struts-default"> 
<action name="login" class="com.test.action.LoginAction"> 
<result name="success">/result.jsp</result> 
</action> 
</package> 
</struts> 


查看 是 否 把 struts-default 中 间 的 “-” 错 写成 了 struts=default; 或 者 把 stmuts 写成 sturts 等 
拼写 。 

(3) 还 有 其 他 一 切 正常 ， 却 把 配置 文件 struts.xml 错误 地 存储 为 struts2.xml。 

(4) 用 MyEclipse 开发 直接 部 署 到 Tomecat 下 面 ， 发 现 MyEclipse 在 部 署 的 时 候 没有 把 
struts.xml 配置 到 Tomcat 到 webapps 的 对 应 项 目下 面 ， 手 工 添加 struts.xml 后 ， 即 可 解决 问题 ! 


2.7.3 Struts 2 Tomcat 6 MyEclipse 6.5 报 404 错误 


Struts 2 Tomcat 6 MyEclipse 6.5 报 404 错误 ? 
胃 网 络 课堂 : http://bbs.itzcn.com/thread-10934-1-1.html 


使 用 MyEclipse 6.5 部 署 Struts 2 做 的 东西 到 Tomcat6 上 总 是 报 404 错误 。 为 什么 ? 不 管 哪 
个 页 面 都 访问 不 到 。 
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jdk5、jvm6、struts2.1.6 jar 包 都 放 好 了 的 。web.xml 文件 中 也 加 入 了 org.apache.struts2. 


dispatcher.FilterDispatcher。struts.xml 文件 配置 如 下 所 示 。 


<?xml] version="1.0" encoding="UTF-8"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<include file="struts-default.xml"/> 
<package name="struts2 helloworld" extends="struts-default"> 
<action name="Login" class="com.telshop.struts2.action.LoginAction"> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
</struts> 


【解决 办 法 】 首先 看 你 的 服务 端 报 什么 错 ? 就 是 Tomcat 上 面 的 报错 情况 。 可 能 很 多 人 都 


遇 到 过 这 种 问题 ， 当 配置 好 虚拟 路 径 时 ， 工 程 完全 可 以 正常 访问 , 但 是 当 在 web.xml 中 配置 完 
Struts 2 之 后 ， 突 然 就 会 报 出 404 错误 ， 页 面 已 经 无 法 找到 了 ， 而 且 Tomcat 中 没有 任何 的 报错 
信息 。 


这 到 底 是 为 什么 呢 ? 

答案 很 简单 : 版 本 问题 ! 

如 果 你 使 用 的 是 Tomcat5.0， 很 抱 菊 ， 不 支持 ! 

我 推荐 你 使 用 Tomcat5.5 再 重新 试 一 次 看 看 。 

同时 ，Struts 2 不 支持 JSP 标签 。 

如 果 你 是 一 个 刚 接触 Struts 2 不 到 一 天 的 新 人 的 话 ， 可 以 按照 下 面 的 方式 试 一 下 ， 也 许 会 


有 不 错 的 学 习 收 获 呢 。 


项 目 开 发 实践 如 下 。 
(1) 在 Eclipse 中 建立 一 个 Web Project， 并 且 向 WEB-INF/lib 中 加 入 所 需 Stmts 2 的 5 个 


jar 包 (可 从 Apache 的 官方 网 站 上 下 载 )。 


struts2-core.jar 
xwork.jar 

ognl .jar 

freemarker .jar 
commons-logging.jar 


(2) 配置 web.xml， 代 码 如 下 所 示 。 


<!--FilterDispatcher 类 在 struts2-core.jar 包 中 --> 
<filter> 
<filter-name>struts2</filter-name> 
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-cl 
ass> 
</filter> 
<filter-mapping> 
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<filter-name>struts2</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 
<!-- 添 加 欢迎 页 面 --> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 


(3) 创建 类 HelloStruts， 需 继承 ActionSupport.java。 


package org.bixy.struts2.demo; 
import com.opensymphony.xwork2.ActionSupport; 
public class Hellostruts extends RctionSupport { 
private String meg="hello,world!"; 
public String getMeg() { 
return meg; 
} 
public void setMeg(String meg) { 
this.meg = meg; 
} 
@Override 
public String execute () throws Exception { 
String f=""; 
if("hello".equals (meg)) 
{ 


f="suc"; 
}else{ 
f="err"; 


} 
return f; 


} 
(4) 在 src 文件 夹 下 创建 struts.xml 文件 ， 配 置 如 下 。 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<include file="struts-default.xml"/> 
<package name="bixy" namespace="/" extends="struts-default"> 
<action name="hello" class="org.bixy.struts2.demo.HelloSstruts"> 
<result name="suc"> 
/hello.jsp 
</result> 
<result name="err"> 


/error.jsp 
</result> 
</action> 
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</package> 
</struts> 
(5) 在 indexjsp 中 编写 提交 表单 的 信息 ， 代 码 如 下 。 
<%@ page language="java" pageEncoding="gbk"%> 
<body> 
<form action="hello.action" method="post"> 
name:<input name="meg" type="text"> 
<input type="submit" value="submit"/> 
</form> 
</body> 


(6) 在 hellojsp 中 编写 显示 输入 信息 的 代码 ， 如 下 所 示 。 


<%@ page language="java" pageEncoding="gbk"%> 


<%@ taglib prefix="s" uri="/struts-tags" %><!-- 引 入 的 struts2 标签 --> 


<body> 
输入 的 内 容 为 : <s:property value="meg"/> 
</body> 


(7) 在 errorjsp 中 编写 出 错时 的 信息 ， 代 码 如 下 。 


<%@ page language="java" pageEncoding="gbk"%> 
<body> 

输入 内 容 有 误 ! 

</body> 


如 果 你 已 经 做 到 这 一 步 了 ， 不 妨 运行 一 下 看 看 ， 执 行 效 果 应 该 不 错 。 


2.7.4 ”Struts 2 配置 问题 Error filterStart 如 何 解决 


Struts 2 配置 问题 Error filterstart 如 何 解 决 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10936-1-1.html 


请 各 位 帮忙 ， 我 的 Struts 2 配置 报 如 下 错误 。 


org.apache .catalina.core.StandardContext start 

严重 : Error filterstart 

2010-5-5 9:07:13 org.apache .catalina.core.StandardContext start 
严重 : Context [/TheLIFE] startup failed due to previous errors 
2010-5-5 9:07:13 org.apache.coyote.httpll.HttpllProtocol start 
信息 : Starting Coyote HTTP/1.1 on http-8080 

2010-5-5 9:07:14 org.apache.jk.common.ChannelSocket init 

信息 : JK: ajpl3 listening on /0.0.0.0:8009 

2010-5-5 9:07:14 org.apache.jk.server.JkMain start 

信息 : Jk running ID=0 time=0/16 config=null 

2010-5-5 9:07:14 org.apache.catalina.startup.Catalina start 
信息 : Server startup in 5567 ms 


报错 信息 使 我 无 从 入 手 ， 因 为 我 的 驱动 包 正 确 加 载 ， 工 程 也 正确 加 载 。xml 文件 配置 是 按 
着 书 上 写 也 没 问题 。 在 Tomcat 中 的 manage 工程 始终 无 法 启动 。 

【解决 办 法 】: 出 现 这 种 错误 ， 一 般 有 以 下 几 种 原因 。 

(1) xml 配置 失误 。filter 应 配置 在 servlet-mapping 前 面 (应 该 都 知道 吧 )。 观 察 class 配置 是 
和 否 能 找 得 到 。 

(2) filter 中 某 段 代码 未 实例 化 (这 个 情况 出 现 得 最 多 ， 要 仔细 检查 )。 

(3) 试 着 把 tomat/server/lib 目录 下 的 commons-digester.jar,commons-beanutils.jar 复制 到 
common/lib/ 目 录 下 ， 因 为 有 些 包 在 部 署 时 没有 被 包含 。 

(4) 类 文件 可 能 没有 部 署 到 tomcat 下 面 ， 致 使 清除 掉 了 整个 工程 ， 建 议 重 新 编译 部 署 ， 启 
动 Tomcat 再 试 一 下 。 


一 、 填 空 题 
(1) 使 用 <filter-class> 标 签 配 置 Struts 2 核心 Filter 的 实现 类 
(2) include 节点 是 Struts2 中 组 件 化 的 方式 ， 可 以 将 每 个 功能 模块 独立 到 一 个 xml 配置 文 


件 中 ， 然 后 用 include 节点 引用 。 通 过 在 struts.xml 文件 中 引入 struts-defaultxml。 
(3) <package> 标 签 的 属性 ， 可 用 来 指定 包 的 命名 空间 。 
(4) 自 定义 的 Action 必须 继承 ActionSupport 类 ， 而 且 需 要 重 写 方法 。 
(5) Result 常见 的 类 型 有 redirect、chain、 
(6) Struts2 的 异常 处 理 机 制 是 通过 在 struts.xml 文 件 中 配置 元 素 完成 的 。 
二 、 选 择 题 
(1) <result> 标 签 中 的 type 属性 配置 为 重 定向 一 个 URL。 
A. chain B. redirect C. dispatcher D. redirectAction 


(2) 在 struts.xml 文 件 中 配置 常量 是 一 种 指定 Struts2 属性 的 方式 。 我 们 使 用 
来 配置 常量 。 
A. <init-param> B. <action> C. <bean> D. <constant> 


(3) 输出 异常 使 用 Struts2 的 <s:property> 标 签 来 实现 ， 但 具体 输出 异常 堆栈 ， 应 使 用 代码 


. <s:property value="exceptionStack"/> 
. <s:property value="exception"/> 


Nm 


. <s:property value="message"/> 
D. <s:property value="exception.message"/> 


(4) Bean 元 素 的 scope 属性 是 配置 Bean 实例 的 作用 域 。 下 面 哪些 是 该 属性 可 配置 的 值 ? 


A. response B. single C. session D. page 
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三 、 上 机 练习 

上 机 练习 : 实现 一 个 添加 并 显示 商品 信息 的 实例 。 

本 案例 定义 了 一 个 商品 类 Productjava, 并 创建 了 一 个 ProductConfirm 类 , 它 是 一 个 Action， 
这 个 Action 获取 用 户 通过 AddProductjsp 页 面 添 加 的 商品 信息 ， 添 加 成 功 之 后 跳 转 到 
ShowProduct.jsp 页 面 ， 该 页 面 通过 <s:iterator> 标 签 将 添加 的 商品 依次 显示 在 页 面 上 。 

最 终 运行 后 添加 商品 效果 如 图 2-12 所 示 ， 显 示 商 品 信息 如 图 2-13 所 示 。 


图 2-12 添加 商品 图 2-13 显示 商品 信息 
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内 容 摘要 : 

HTTP 协议 中 ， 传 递 的 任何 内 容 都 是 String 类 型 。 一 旦 需要 非 String 类 型 的 对 象 ， 例 如 int 
或 者 Date, 就 需要 在 收 到 HTTP 请 求 的 数据 时 ,首先 将 String 类 型 的 数据 变换 为 对 应 类 型 的 数 
据 ， 然 后 再 使 用 该 数据 。 这 个 变换 过 程 就 是 类 型 转换 。 

Struts 2 提供 了 非常 强大 的 类 型 转换 机 制 ，Struts 2 的 类 型 转换 是 基于 OGNL 表达 式 的 ， 只 
要 把 HTML 输入 项 (表单 元 素 和 其 他 GET/POST 的 参数 ) 命 名 为 合法 的 OGNL 表达 式 ， 就 可 以 
充分 利用 Struts 2 的 类 型 转换 机 制 。 

本 章 将 介绍 Struts 2 中 的 类 型 转换 及 转换 异常 处 理 。 

学 习 目 标 : 

@@ 熟悉 类 型 转换 的 作用 。 
熟练 使 用 类 型 转换 器 。 
掌握 Struts 2 对 null 属性 的 处 理 。 
掌握 Struts 2 的 类 型 转换 对 List、Map 和 Set 的 支持 。 
熟练 开发 自 定义 的 类 型 转换 器 。 
掌握 对 类 型 转换 错误 的 处 理 。 
熟练 使 用 注解 来 配置 类 型 转换 。 


ts 2 saz 二 


3.1 类 型 转换 的 意义 


所 有 的 MVC 框架 ， 都 是 表现 层 的 解决 方案 ， 都 需要 负责 收集 用 户 请 求 参数 ， 并 将 请 求 参 
数 传 给 应 用 的 控制 器 组 件 。 此 时 问题 出 现 了 ， 所 有 的 请 求 参数 都 是 字符 串 数据 类 型 ， 但 Java 
是 强 类 型 的 语言 ， 因 此 MVC 框架 必须 将 这 些 字 符 串 请 求 参数 转换 成 相应 的 数据 类 型 。 本 节 将 
为 大 家 介绍 一 下 MVC 中 表现 层 (View) 的 数据 类 型 转换 。 


上 视频 教学 ， 光盘 /videos/03/type.avi 四 长 度 : 15 分 钟 


3.1.1 基础 知识 一 一 类 型 转换 的 意义 


对 于 一 个 成 熟 的 、 智 能 的 MVC 框架 而 言 ， 不 可 避免 地 需要 实现 类 型 转换 。 因 为 B/S( 浏 览 
器 /服务 器 ) 应 用 与 传统 的 C/S( 客 户 端 /服务 器 ) 应 用 程序 不 同 , B/S 结构 应 用 的 请 求 参数 是 通过 浏 
览 器 发 送 到 服务 器 的 ， 这 些 参数 不 可 能 有 丰富 的 数据 类 型 ， 因 此 必须 在 服务 器 端 完成 数据 类 型 


转换 。 
MVC 框架 是 一 个 表现 层 的 解决 方案 ， 理 应 提供 类 型 转换 的 支持 ，Struts 2 提供 了 功能 非常 
强大 的 类 型 转换 支持 。 


对 于 Web 应 用 而 言 ， 表 现 层 主要 用 于 与 用 户 交 互 ， 包 括 收集 用 户 输入 数据 ， 向 用 户 呈 现 
服务 器 状态 数据 。 因 此 表现 层 数据 的 流向 主要 有 两 个 方向 : 输入 数据 和 输出 数据 。 对 于 将 服务 
器 状态 呈现 给 客户 整个 方向 而 言 ， 不 管 是 Java 的 输出 语句 ， 还 是 JSP 的 输出 语句 ， 都 支持 多 
种 数据 类 型 的 直接 输出 ， 应 用 程序 只 需要 使 用 简单 的 输出 语句 即 可 将 服务 器 状态 呈现 给 浏览 
器 。 对 于 输入 数据 ， 则 需要 完成 由 字符 串 数 据 向 多 种 数据 类 型 转换 。 程 序 通常 无 法 自动 完成 数 
据 类 型 转换 ， 需 要 在 代码 中 手动 转换 。 表 现 层 数据 的 流向 和 类 型 转换 如 图 3-1 所 示 。 


用 户 


服务 器 


3-1 ”表现 层 数据 的 流向 和 类 型 转换 


表现 层 的 另 一 个 数据 处 理 是 数据 校 验 ， 数 据 校 验 可 分 为 客户 端 校 验 和 服务 器 端 校 验 两 种 。 
客户 端 校 验 和 服务 器 端 校 验 都 是 必 不 可 少 的 ， 二 者 分 别 完成 不 同 的 过 滤 。 
关于 数据 校 验 的 知识 ， 将 会 在 后 面 章节 中 详细 介绍 。 


EtD >> 


第 3 章 数据 类 型 大 转换 


3.1.2 ”实例 描述 


还 记得 刚 开始 接触 Java Web 编程 时 获取 表单 元 素 吗 ? 当初 采用 了 HttpServlet Request 的 
getParameter(“ 元 素 name”) 方 法 来 获取 表单 元 素 ， 而 这 种 获取 方法 全 部 都 是 String 类 型 ， 当 
输入 一 个 年 龄 或 者 日 期 的 时 候 , 获取 到 的 是 一 个 只 包含 数字 或 者 日 期 格式 的 字符 串 , 但 是 Bean 
类 中 的 年 龄 和 出 生日 期 分 别 是 int 类 型 和 java.util.Date 类 型 ,怎么 把 获取 的 表单 元 素 值 赋 给 Bean 
的 属性 呢 ? 这 就 需要 用 到 类 型 转换 。 

以 下 的 实例 展示 的 是 当时 的 做 法 。 


3.1.3 ”实例 应 用 


【 例 3-1】 用 户 注册 输入 数据 类 型 大 转换 。 

(1) 新 建 Struts 2-Converter 项 目 ， 在 该 项 目下 新 建 com.struts2.bean 包 ， 并 在 其 下 创建 
UserBean 类 ， 用 于 收集 用 户 输入 的 注册 信息 。 注 册 信 息 包括 用 户 名 、 密 码 、 年 龄 、 出 生日 期 。 
完整 代码 如 下 。 


package com.struts2.bean; 

import java.util.Date; 

public class UserBean { 
private String name;// 用 户 名 
private String pass;// 密 码 
private int age;// 年 龄 
private Date birth;// 出 生日 期 
// 无 参 构造 函数 


public UserBean(){ 


} 
// 有 参数 的 构造 器 


public UserBean (String name,String pass,int age,Date birth){ 


this.name=name; 
this.pass=pass; 
this.age=age; 
this.birth=birth; 


} 
/* 下 面 是 上 面 4 个 属性 的 set 、get 方法 ， 这 里 省 略 */ 


} 


(2) 在 com.struts2.servlet 包 下 新 建 Register.jjava， 用 于 将 页 面 收集 到 的 数据 封装 成 一 个 
UserBean 的 值 对 象 。 该 Servlet 的 代码 如 下 。 


package com.struts2.servlet; 


import 
import 
import 
import 
import 


java.io.IOException; 
java.io.PrintWriter; 
java.text.SimpleDateFormat; 
java.util.Date; 
javax.servlet.ServletException; 
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import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
import com.struts2.bean.UserBean; 
public class Register extends HttpServlet { 
J/ 
* Servlet 的 服务 响应 方法 
a 
Qoverride 
protected void service(HttpServletRequest request, HttpServletResponse 
response) throws ServletException, IOException { 
// 设 置 解码 格式 
request .setCharacterEncoding ("GBK"); 
// 下 面 依次 获取 4 个 参数 ， 获 取 的 参数 全 部 为 字符 串 类 型 
String name=request .getParameter ("name"); 
String pwd=request .getParameter ("pass"); 
String strAge=request .getParameter ("age"); 
String strBirth=request .getParameter ("birth"); 
// 下 面 进行 类 型 转换 
// 字 符 串 类 型 向 整 型 转换 
int age=Integer.parseInt (strAge); 
// 使 用 SimpleDateFormat 将 字符 串 向 日 期 格式 转换 
// 指 定 转换 格式 ， 日 期 字符 串 ， 必 须 按 yyyy-MM-dd 的 格式 输入 
SimpleDateFormat sdf=new SimpleDateFormat ("yyyy-MM-dd"); 
Date birthDate=null; 
try { 
birthDate=sdf.parse (strBirth); 
} catch (Exception e) { 
e.printstackTrace (); 


} 
// 将 类 型 转换 后 的 值 封 装 成 UserBean 的 值 对 象 
UserBean userBean=new UserBean (name,pwd,age,birthDate); 
// 用 servlet 直接 输出 
response.setContentType ("text/html;charset=gb2312"); 
// 获 得 页 面 输出 流 
PrintWriter out=response.getWriter(); 
out.print ("<html><head><title>"); 
// 输 出 页 面 标题 
out .println (" 类 型 转换 页 面 ") ; 
out.println("</title></head><body>"); 
out .println ("<h1> 类 型 转换 </h1>"); 
out.println (userBean.getName ()+"<br>"); 
out.println (userBean.getPass()+"<br>"); 
out.println (userBean.getAge()+"<br>"); 
out.println (userBean.getBirth()+"<br>"); 
out.println("</body></html>"); 
} 
@Override 
public void destroy() { 
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super.destroy (); 


} 


(3) 为 了 让 上 面 的 Servlet 可 以 直接 生成 对 浏览 者 的 响应 , 必须 将 该 Servlet 配置 在 Web 应 
中 ， 配 置 Servlet 必须 在 web.xml 文件 中 增加 下 面 的 代码 片段 。 


<servlet> 


<servlet-name>regist</servlet-name> 
<servlet-class>com.struts2.servlet.Register</servlet-class> 
</servlet> 
<servlet-mapping> 
<servlet-name>regist</servlet-name> 
<url-pattern>/regist</url-pattern> 
</servlet-mapping> 


(4) 创建 用 户 注册 页 面 register.jsp。 因 为 上 面 配置 的 Servlet 映射 的 URL 为 /regist， 故 将 表 
单 页 面 的 <form.../> 元 素 的 action 属性 设置 为 regist， 而 且 该 表单 将 提交 到 Servlet 类 一 Register 
类 中 。 代 码 片段 如 下 。 
<form action="regist" method="post"> 
username:<input type="text" name="name"><br> 
userpass:<input type="password" name="pass"><br> 
userage:<input type="text" name="age"><br> 
userbirth:<input type="text" name="birth"><br> 
<input type="submit" value="Regist" align="center"> 
</form> 
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在 图 3-2 所 示 的 页 面 中 , 依次 在 username 文本 框 中 输入 lizanhong; 在 userpass 口令 框 中 输 
入 123456; 在 userage 文本 框 中 输入 22: 在 userbirth 文本 框 中 输入 1989-02-21。 单 击 Regist 
按钮 ， 出 现 如 图 3-3 所 示 的 界面 。 


ue Fek 21 00:00:00 CST 1989 


图 3-3 ”类 型 转换 效果 


3.1.5 ”实例 分 析 


pe 


在 上 面 的 例子 中 , 单 击 Regist 按钮 后 , 表单 提交 至 Register 类 , 即 Servlet 类 中 , 在 该 Servlet 
类 中 获取 用 户 输入 的 四 个 字符 串 参 数 ， 并 经 过 类 型 转换 后 封装 到 一 个 UserBean 的 对 象 中 。 对 
于 这 个 应 用 ， 程 序 员 在 Servlet 中 进行 类 型 转换 ， 并 将 其 封装 成 请 求 参数 的 值 对 象 由 于 这 些 类 
型 转换 操作 全 部 手工 完成 ， 因 此 显得 异常 繁琐 。 

对 于 MVC 框架 而 言 ， 它 一 样 需 要 将 请 求 参 数 封装 成 VO 对 象 。 因 此， 必须 把 请 求 参数 转 
换 成 VO 类 里 各 属性 对 应 的 数据 类 型 一 一 这 就 是 类 型 转换 的 意义 。 


3.2 使 用 Struts 2 的 类 型 转换 


在 B/S 应 用 中 ， 将 字符 串 请 求 参 数 转 换 为 相应 的 数据 类 型 ， 是 MVC 框架 提供 的 功能 。 
Struts 2 作为 很 好 的 MVC 框架 实现 者 ， 也 提供 了 类 型 转换 机 制 。 


A9 
上 视频 教学 ， 光盘/videos/03/internal.avi 全 长 度 : 11 分钟 


3.2.1 基础 知识 Struts 2 对 类 型 转换 的 支持 


Struts 2 类 型 转换 机 制 的 基础 是 OGNL 表达 式 ， 在 前 面 章节 的 例子 程序 中 ， 相 信 读 者 已 经 
感受 到 了 Struts 2 强大 的 类 型 转换 能 力 。 
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1. 使 用 OGNL 表达 式 命名 参数 


在 用 户 注册 Action 中 存在 一 个 user 属性 (类 型 为 User), 并 提供 了 user 属性 的 getter 和 setter 
方法 。 在 为 表单 输入 元 素 命 名 时 ， 只 需要 把 它们 命名 为 合法 的 OGNL 表达 式 ， 例 如 : 
user.username、user.age、user.birthday 等 ， 这 样 就 可 以 使 用 Struts 2 的 类 型 转换 功能 了 。Struts 2 
框架 会 自动 对 输入 数据 按照 user 对 象 的 属性 的 类 型 进行 类 型 转换 (如 果 user 对 象 不 存在 ， 框 架 
还 会 为 此 创建 user 对 象 )， 并 用 转换 后 的 数据 封装 user 对 象 。 

2. Struts 2 内 置 的 类 型 转换 器 


Strts 2 框架 可 以 自动 转换 常见 的 数据 类 型 。 这 些 转换 工作 ， 完 全 可 以 交 给 Struts 2 系统 实 
现 , 开发 者 不 用 再 自 定义 类 型 转换 器 。 常 用 的 类 型 转换 包括 下 列 类 型 和 String 类 型 的 相互 转换 。 
1) String 
将 int、long、double、boolean、String 类 型 的 数组 或 java.util.Date 类 型 转换 为 字符 串 。 
2) boolean/Boolean 
在 字符 串 和 布尔 值 之 间 进行 转换 。 
3) char/Character 
在 字符 串 和 字符 之 间 进 行 转换 。 
4) int/Integer、 float/Float、 long/Long、 double/Double 
在 字符 串 和 数值 型 的 数据 之 间 进 行 转换 。 
5) date 
在 字符 串 和 日 期 类 型 之 间 进 行 转换 。 对 于 日 期 类 型 , 采用 SHORT 格式 来 处 理 输 入 和 输出 ， 
使 用 当前 请 求 关联 的 Locale 来 确定 日 期 格式 。 
6) array 
由 于 数组 元 素 本 身 就 有 类 型 ，Struts 2 使 用 元 素 类 型 对 应 的 类 型 转换 器 ， 将 字符 串 转换 为 
数组 元 素 的 类 型 ， 然 后 再 设置 到 新 的 数组 中 。 
7) collection 
如 果 不 能 确定 对 象 类 型 ， 则 假定 集合 元 素 类 型 为 String， 并 创建 一 个 新 的 ArrayList， 存 放 
所 有 的 字符 串 。 
@ 》 对 于 数组 的 类 型 转换 将 按照 数组 元 素 的 类 型 ， 尝 试 独立 地 转换 每 一 项 。 和 任何 其 
生 守 他 的 类 型 转换 一 样 ， 在 类 型 转换 的 处 理 过 程 中 ， 如 果 转 换 不 能 执行 ， 标 准 的 类 型 
转换 错误 报告 将 被 用 于 指出 发 生 的 问题 。 


3. null 属性 的 处 理 


当 发 现 null 引用 时 ,null 属性 处 理 将 自动 创建 对 象 . 如 果 Action 上 下 文中 存在 键 #KCREATE 
NULL OBJECTS ， 并 且 其 值 为 tue( 这 个 键 只 在 com.opensymphony.xwork2.interceptor. 
ParametersInterceptor 执行 期 间 被 设置 )， 那 么 引发 NullPointerException 的 OGNL 表达 式 将 被 暂 
停 求 值 。 此 时 系统 将 通过 创建 所 需 对 象 的 方法 来 自动 尝试 解决 null 引用 。 


< 
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处 理 null 引用 时 将 遵循 下 列 规 则 。 

@ ”如 果 属 性 声明 为 Collection 或 者 List， 那 么 将 创建 一 个 ArrayList 对 象 ， 并 赋值 给 null 
引用 。 

@ ”如果 属性 声明 为 Map， 那 么 将 创建 一 个 HashMap 对 象 ， 并 赋值 给 null 引用 。 

@ 如果 null 属性 是 一 个 具有 无 参 构造 方法 的 简单 Bean， 那 么 将 使 用 ObjectFactory 的 
buildBean() 方 法 创建 一 个 Bean 的 实例 。 


$ 例如， 如 果 表 单元 素 中 有 一 个 文本 字段 命名 为 person.name， 而 表达 式 person 计算 
结果 为 null， 那 么 ObjectFactory 类 将 被 调用 。 由 于 表达 式 person 的 类 型 为 Person 
类 ， 因 此 一 个 新 的 Person 对 象 将 被 创建 ， 并 赋值 给 这 个 null 引用 。 最 后 ，name 
值 被 赋 给 该 对 象 的 name 属性 。 整 个 过 程 就 是 系统 自动 创建 一 个 Person 对 象 ， 通 
过 调用 setPerson() 方 法 将 它 赋 给 null 引用 ， 最 后 调用 getPerson0.getName0 来 设置 
name 属性 ， 而 这 通常 也 是 读者 想 要 的 结果 。 


证 
六 


4. 局 部 类 型 转换 器 

上 面 介绍 了 几 种 常见 的 类 型 转换 器 ， 关 于 类 型 转换 器 的 注册 方式 ， 主 要 有 如 下 三 种 。 

@ ”注册 局 部 类 型 转换 器 : 局 部 类 型 转换 器 仅仅 对 某 个 Action 的 属性 起 作用 。 

@ ”注册 全 局 类 型 转换 器 : 全 局 类 型 转换 器 对 所 有 Action 的 特定 类 型 的 属性 都 会 生效 。 

@ ”使 用 JDK1.5 的 注释 来 注册 类 型 转换 器 : 通过 注释 方式 来 生成 类 型 转换 器 。 

下 面 介绍 的 是 局 部 类 型 转换 器 的 注册 方式 , 要 注册 类 型 转换 器 只 需 提供 文件 名 为 如 下 格式 
的 文件 。 


ClassName-conversion.properties 
其 中 ，“ClassName” 是 需要 转换 器 生效 的 类 名 ， 后 面 的 “-conversion.properties” 字 符 串 
固定 的 。 该 文件 是 一 个 典型 的 Properties 文件 , 文件 由 key-value 对 组 成 。 文 件 内 容 如 下 所 示 。 
PropertyName= 类 型 转换 器 类 
ClassName-conversion.properties 文件 由 多 个 “propertyName= 类 型 转换 器 类 ”项 组 成 ， 其 中 
| “propertyName” 是 类 中 需要 类 型 转换 器 转换 的 属性 名 ， 类 型 转换 器 类 是 开发 者 实现 的 类 型 转 
换 器 的 全 限定 类 名 (需要 加 包 前 级 )。 
例如 ， 在 用 户 Action 类 (UserAction) 中 有 一 个 User 动作 类 属性 user， 同 时 又 有 user 属性 
的 转换 器 类 UserConverter 类 来 完成 类 型 转换 ， 可 以 命名 类 型 转换 器 注册 文件 为 UserAction- 
conversion.properties， 并 在 其 内 添加 如 下 内 容 。 


user=com.struts2.convert.UserConverter 


Lis 


UserAction-conversion.properties 文件 应 该 与 UserAction.class 放 在 相同 位 置 ( 因 为 
UserAction 的 包 为 com.struts2.actions， 因 此 该 文件 应 该 放 在 Web 应 用 的 WEB-INF/classes/com/ 
struts2/actions 路 径 下 )。 

到 此 ， 局 部 类 型 转换 器 注册 成 功 。 当 浏览 者 提交 请 求 时 ， 请 求 中 的 user 请 求 参 数 将 会 先 被 
该 类 型 转换 器 处 理 。 
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局 部 类 型 转换 器 只 对 指定 类 的 特定 属性 起 作用 , 这 具有 很 大 的 局 限 性 一 一 花费 了 大 量 的 时 
间 完 成 了 一 个 类 型 转换 器 ， 却 只 能 使 用 一 次 (对 一 个 类 有 效 )， 这 太 浪 费 了 。 通 常 我 们 会 将 类 型 
转换 器 注册 成 全 局 类 型 转换 器 ， 让 该 类 型 转换 器 对 该 类 型 的 所 有 属性 起 作用 。 


@” 局 部 类 型 转换 器 只 对 指定 类 的 指定 属性 生效 ， 全 局 类 型 转换 器 对 指定 类 型 的 全 部 
机 果 属性 起 作用 。 


5. 全 局 类 型 转换 器 


假设 应 用 中 有 多 个 Action 都 包含 了 User 类 型 的 属性 , 如 果 多 次 重复 注册 局 部 类 型 转换 器 ， 
将 是 很 烦琐 的 事情 。 因 此 ，Struts 2 提供 了 全 局 类 型 转换 器 ， 它 对 指定 类 型 的 全 部 属性 有 效 。 
下 面 是 一 个 请 求 对 应 的 Action 的 代码 片段 。 


Public class UserAction extends RARctionSupPort { 
// 转 换 信息 
private String tip; 
// 封 装 user 请 求 参 数 的 属性 
private User user; 
// 封 装 customer 请 求 参数 的 属性 
private User customer; 
// 封 装 birth 请 求 参 数 的 属性 
private Date birth; 
// 处 理 用户 请 求 的 execute () 方 法 
@Override 
public String execute () throws Exception { 
if(getUser() .getName () .equals ("admin") &g&getUser () .getPass(). 
equals ("admin")){ 
setTip ("转换 成 功 ") ; 
return SUCCESS; 
} 
else { 
setTip ("转换 失败 ") ; 
return ERROR; 
} 


} 
/* 下 面 是 上 面 所 有 属性 的 set 、get 方法 ， 这 里 省 略 */ 


} 


在 上 面 的 Action 中 ，user 和 customer 两 个 属性 的 类 型 都 是 User 类 型 一 一 对 于 一 个 Action 
里 包含 两 个 User 类 型 属性 的 情况 ， 可 以 使 用 一 个 局 部 类 型 转换 器 注册 文件 完成 注册 ; 但 如 果 
系统 中 的 多 个 Action 都 包含 User 类 型 的 属性 ， 则 应 该 使 用 全 局 类 型 转换 器 注册 。 

注册 全 局 类 型 转换 器 提供 一 个 xwork-conversion.properties 文件 ， 该 文件 也 是 Properties 文 
件 ， 其 内 容 由 多 个 “符合 类 型 = 对 应 类 型 转换 器 ”项 组 成 ， 其 中 “复合 类 型 ”指定 需要 完成 类 
型 转换 的 复合 类 ，“ 对 应 类 型 转换 器 ”指定 所 指定 类 型 转换 的 转换 器 。 
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注册 全 局 类 型 转换 器 的 注册 文件 代码 如 下 所 示 。 


com.struts2.model .User=com.struts2.convert .UserConverter 
一 旦 注册 了 上 面 的 全 局 类 型 转换 器 ， 该 全 局 类 型 转换 器 就 会 对 所 有 User 类 型 属性 起 作用 。 
6. Struts 2 对 Collection 和 Map 的 支持 
Struts 2 对 集合 类 型 的 转换 提供 了 很 好 的 支持 ， 可 以 用 集合 对 象 来 保存 表单 提交 的 数据 ， 
这 对 于 同时 提交 多 个 相同 类 别 的 信息 将 会 非常 方便 。 
1) ”指定 集合 元 素 的 类 型 
修改 上 面 Action 类 代码 ， 修 改 后 的 Action 类 代码 片段 如 下 。 
public class UserAction extends ActionSupPort { 
// 声 明 user 集合 
private List user; 


@Override 
public String execute () throws Exception { 


if((User)getUser () .get (0)) .getName () .equals ("admin") &&( (User)getUser(). 
get (0)) .getPass () .equals ("admin")) 
{ 


1 

Public List getUser() { 
return user; 

} 

public void setUser (List user) { 
this.user = user; 

} 

} 


显然 , 对 于 上 面 的 user 属性 ， 系 统 根本 不 清楚 List 里 元 素 的 类 型 ， 类 型 转换 器 也 就 无 法 起 
到 作用 。 因 此 ,为 了 让 系统 指导 List 里 的 元 素 类 型 ， 为 了 让 系统 的 类 型 转换 器 起 到 作用 ， 我 们 
可 以 用 以 下 两 种 方法 。 
@@ ”使 用 泛 型 来 限制 集合 里 元 素 的 类 型 。 
@ ”使 用 Struts 2 的 配置 文件 : 使 用 局 部 类 型 转换 的 配置 文件 来 制定 集合 元 素 的 数据 类 型 。 
为 了 在 局 部 类 型 转换 文件 中 指定 集合 元 素 的 类 型 , 应 该 在 局 部 类 型 转换 文件 中 增加 如 下 的 
key-value 对 。 


Element xxx- 复 合 类 型 

上 面 key-value 对 中 的 “Element” 是 固定 的 ，“xxx” 是 Action 中 的 集合 属性 名 ， 复 合 类 
型 是 集合 元 素 类 型 的 全 限定 类 名 (应 该 增加 完整 的 包 前 缀 )， 例 如 修改 前 面 所 讲 的 局 部 类 型 转换 
器 中 的 UserAction-conversion .properties 文件 内 容 (该 文件 内 容 只 有 一 行 代码 ) 代 码 如 下 。 

# 指 定 Action 类 的 user 集合 属性 的 元 素 为 com. struts2.model1.User 实例 


Element user=com.struts2.model.User 


m= >> 
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增加 定义 后 ， 系 统 将 可 以 识别 出 user 集合 属性 的 集合 元 素 是 com.struts2.model.User 类 型 ， 
相应 的 类 型 转换 器 将 可 以 对 该 属性 生效 。 

对 于 Map 类 型 的 属性 ， 则 需要 同时 指定 Map 的 key 类 型 和 value 类 型 ， 为 了 指定 Map 类 
型 属性 的 key 类 型 ， 应 该 在 局 部 类 型 转换 文件 中 增加 如 下 项 。 

Key_xxx= 复 合 类 型 

其 中 “Key” 是 固定 的 ，“xxx” 是 Map 类 型 属性 的 属性 名 ， 复 合 类 型 指定 的 是 Map 属性 
的 key 类 型 的 全 限定 类 名 。 为 了 指定 Map 类 型 属性 的 value 类 型 ， 应 该 在 局 部 类 型 转换 文件 中 
增加 如 下 项 。 

Element xxx= 复 合 类 型 

其 中 “Element” 是 固定 的 ，“xxx” 是 Map 类 型 属性 的 属性 名 ， 复 合 类 型 指定 的 是 Map 
属性 的 value 类 型 的 全 限定 类 名 。 

通过 上 面 的 局 部 类 型 转换 元 素 指定 集合 元 素 类 型 后 ， 系 统 的 类 型 转换 器 将 可 以 正常 工作 。 
为 了 在 JSP 页 面 中 输出 List 属性 的 某 个 元 素 的 值 ， 可 以 使 用 如 下 格式 。 

<s:property value=" 集 合 属性 名 [索引 ] .集合 元 素 属性 名 "/> 

下 面 是 JSP 页 面 中 输出 Action 实例 中 属性 的 代码 片段 。 

用 户 1 的 用 户 名 为 : <s:property value="user[0] .name"/> 


图 》 对 于 set 关 型 的 属性 是 无 法 通过 索引 访问 集合 元 素 的 ， 因 为 Set 是 无 序 集合 .但 是 ， 
注意 | 。 Struts 2 提供 了 一 个 指定 索引 属性 的 方法 可 以 访问 Set 类 型 的 属性 。 
2) ”指定 集合 元 素 的 索引 属性 
为 了 更 好 地 支持 Set 类 型 的 属性 ，Struts 2 允许 指定 Set 集合 元 素 的 key 属性 一 该 key 属 
性 可 以 唯一 地 标识 该 元 素 。 假 设 有 如 下 的 Action 类 。 


public class UserAction extends ActionSupport { 
//Action 包含 了 一 个 Set 类 型 的 属性 ， 用 于 封装 包含 多 个 值 的 请 求 参数 
private Set user; 
/*# 
* 处 理 用 户 请 求 的 execute () 方 法， 直接 返回 success 字符 串 
Qoverride 
public String execute () throws Exception { 
return SUCCESS; 
WW 
public Set getUser() { 
return user; 
} 
public void setUser (Set user) { 
this.user = user; 


} 
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在 上 面 的 Action 类 中 , 包含 了 一 个 Set 类 型 的 属性 ， 该 属性 没有 使 用 泛 型 来 限制 集合 元 素 
的 类 型 ， 因 此 应 该 在 局 部 类 型 转换 文件 中 指定 集合 元 素 的 类 型 。 除 此 之 外 ， 为 了 更 方便 地 访问 
Set 属性 中 的 集合 元 素 ， 需 要 指定 集合 元 素 的 索引 属性 ， 指 定 集合 元 素 的 索引 属性 通过 在 局 部 
类 型 转换 文件 中 增加 如 下 项 即 可 。 

Keyproperty 集合 属性 名 = 集合 元 素 的 索引 属性 名 


其 中 ， 上 面 的 “集合 属性 名 ”是 Action 中 的 集合 属性 名 (user)， 集 合 元 素 的 索引 属性 名 是 
可 以 唯一 标识 集合 元 素 的 属性 名 。 例 如 : 

# 指 定 user 集合 属性 的 集合 元 素 类 型 是 com. struts2.model .User 

Element user=com.struts2.model .User 

# 指 定 user 集合 属性 里 集合 元 素 的 索引 属性 是 name 

KeyProperty user=name 

一 旦 指定 了 集合 元 素 的 索引 属性 值 后 ， 就 可 以 直接 通过 该 索引 属性 值 来 访问 该 集合 元 素 ， 
避免 了 只 能 直接 访问 有 序 集合 里 元 素 的 缺陷 。 下 面 是 在 JSP 页 面 中 通过 索引 属性 直接 访问 Set 
元 素 的 代码 片段 。 


用 户 1 的 用 户 名 为 : <s:property value="user ('admin') .name"/> 

通过 代码 可 以 看 出 , 直接 访问 Set 元 素 的 方式 是 : 集合 属性 名 (索引 属性 值 ) 一 一 该 方式 访 
问 的 是 索引 属性 为 指定 值 的 集合 元 素 。 

1 》 上 面 访问 Set 元 素 用 的 是 圆 括 号 ， 而 不 是 方 括号 。 但 对 于 数组 、List 和 Map 属性 
友和 | 。 来 说 ， 则 需要 通过 方 括号 来 访问 指定 集合 元 素 . 


3.2.2 ”实例 描述 


大 家 都 做 过 各 种 各 样 的 购物 管理 系统 吧 ! 也 许 只 做 过 订购 一 件 商品 的 管理 系统 ;也许 运用 
过 List 集合 获取 购买 的 物品 信息 Z…… 学 了 Struts 2 的 类 型 转换 ， 我 们 将 采用 Map 类 型 来 获取 
购买 商品 信息 ， 认 识 一 下 Struts 2 的 类 型 转换 在 其 中 起 着 什么 样 的 作用 。 没有 了 Struts 2 的 类 型 
转换 ， 系 统 是 否 还 能 正常 运行 呢 ? 

下 面 将 使 用 Map 类 型 实现 图 书 购 物 系 统 。 


3.2.3 ”实例 应 用 


【 例 3-2】 使 用 Map 实现 图 书 购物 系统 。 
(1) 在 Web 应 用 的 web.xml 文件 中 配置 Struts 2 的 控制 器 FilterDispatcher, 配置 代码 如 下 。 


<filter> 
<filter-name>struts2</filter-name> 
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-cl 
ass> 
</filter> 
<filter-mapping> 


m= > 
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<filter-name>struts2</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>*.jsp</url-pattern> 
</filter-mapping> 


(2) 编写 Book 类 。Book 类 是 一 个 JavaBean 类 ， 是 图 书信 息 的 对 象 化 标识 。 在 src 目录 下 
新 建 com.struts2.model 包 ， 在 该 包 下 新 建 Book 类 ， 代 码 如 下 。 


Package com.struts2.model; 
import java.io.Serializable; 
public class Book implements Serializable { 
private String title;// 书 名 
private float price;// 价 格 
private int amount;// 购 买 数量 
/* 下 面 是 上 面 3 个 属性 的 set、get 方法 ， 这 里 省 略 */ 
} 


(3) 编写 BookAction 类 。BookAction 是 一 个 Action 类 ， 该 类 只 是 提供 了 一 个 保存 用 户 提 
交 的 图 书信 息 的 Map 对 象 。 在 src 目录 下 新 建 com.struts2.actions 包 , 在 该 包 下 新 建 BookAction 
类 ， 继 承 自 ActionSupport， 完 整 的 代码 如 下 所 示 。 


package com.struts2.actions; 
import java.util.Map; 
import com.opensymphony.xwork2.ActionSupport; 
public class BookAction extends ActionSupport { 
// 保 存 Book 对 象 的 Map 
private Map books; 
@Override 
public String execute () throws Exception { 
return SUCCESS; 
} 
public Map getBooks() { 
return books; 
} 
public void setBooks (Map books) { 
this.books = books; 
站 


傅 | books 实例 变量 的 类 型 是 Map 接口 ， 并 且 我 们 没有 对 它 进行 初始 化 。 
| 


在 BookAction 类 中 ， 没 有 给 出 books Map 的 key 和 value 的 类 型 ，Map 的 key 和 value 的 
类 型 可 以 在 BookAction-conversion.properties 文件 中 指出 。 

(4) 继续 在 com.struts2.actions 包 下 ， 即 BookAction 类 的 同 目录 下 新 建 BookAction- 
conversion .properties 文件 ， 代 码 内 容 如 下 。 
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#Map 类 型 的 属性 books 的 key 类 型 为 string 
Key books=java.lang.String 
#Map 类 型 的 属性 books 的 value 类 型 为 Book 


Element books=com.struts2.model .Book 


(5) 在 WebRoot 下 新 建 addBook.jsp 页 面 ， 用 于 收集 订购 图 书信 息 。 代 码 如 下 。 


<s@ page language="java" import="java.util.*" pageEncoding="GBK"%®> 
<%@taglib prefix="s" uri="/struts-tags" 各 > 
<s:formaction="convert/bookConfirm.action" method="post" theme="simple"> 
<TABLE cellSpacing=0 cellPadding=2 width="95%" align=center border=0> 
<TR> 
<TD> 书 名 </TD> 
<TD > 价格 </TD> 
<TD> 数 量 </TD> 
</TR> 
<s:iterator value="new int[3]" status="status"> 
<TR> 
<s:set name="index" value="#status.index+1"/> 
4 
<s:set name="books" value='"books["+"\"'book"+#index+"\']"'/> 
= 
<s:set name="books" value="'books.'+'book'+#index"/> 
<TD ><s:textfield name="%{#books+' .title'}"/></TD> 
<TD><s:textfield name="%{#books+' .price'}"/></TD> 
<TD><s:textfield name="%{#books+' .amount'}"/></TD> 
</TR> 
</s:iterator> 
<TR> 
<TD colspan="3" align="center"> 
<input type="submit" value=" 订 购 图 书 "> 
</TD> 
</TR> 
</TABLE> 
</s:form> 


如 果 是 用 Map 来 保存 数据 ， 那 么 在 为 表单 输入 元 素 命名 时 ， 需 要 使 用 books[‘key*] 或 者 
books.key 格式 的 名 字 ， 在 上 面 的 代码 中 ， 同 时 给 出 了 这 两 种 格式 的 命名 ， 对 于 books[‘key’] 这 
种 格式 是 在 JSP 注释 中 给 出 的 。 

(6) 在 strmts.xml 文件 中 配置 BookAction 类 。 完 整 代码 如 下 。 


<?xml version="1.0" encoding="UTF-8" ?> 

<!-- 指定 拦截 器 的 DTD 信息 --> 

<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 

<struts> 
<!-- 通过 常量 配置 struts2 所 使 用 的 解码 集 --> 


<constant name="struts.il8n.encoding" value="gbk" /> 
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<constant name="struts.devMode" value="true" /> 
<package name="convert" namespace="/convert" extends="struts-default"> 
<action name="bookConfirm" class="com.struts2.actions.BookAction"> 
<result name="success">/showBooks.jsp</result> 
</action> 
</package> 
</struts> 


(7) 在 WebRoot 下 新 建 获取 订购 图 书信 息 页 面 showBooksjsp， 代 码 如 下 。 


<%@ page language="java" import="java.util.*" pageEncoding="GBK"%®> 
<%@taglib prefix="s" uri="/struts-tags" %> 
<TABLE cellSpacing=0 cellPadding=2 width="95%" align=center border=0> 
<TR> 
<TD> 书 名 </TD> 
<TD > 价格 </TD> 
<TD> 数 量 </TD> 
</TR> 
<s:iterator value="books"> 
<TR> 
<TD ><s:property value="value.title"/></TD> 
<TD><s:property value="value.price"/></TD> 
<TD><s:property value="value.amount"/></TD> 
</TR> 
</s:iterator> 
</TABLE> 


books 的 类 型 为 Map， 使 用 iterator 标签 迭代 Map 时 ， 实际 迭代 的 是 Map 的 entrySet0 方 法 
返回 的 Set 集合 ， 在 该 集合 中 是 一 组 Map.Entry 对 象 。 表 达 式 value 获取 Map 中 的 值 ， 即 Book 
对 象 ， 表 达 式 value.title 则 获取 Book 对 象 的 title 属性 。 

3.2.4 运行 结果 


运行 addBook.jsp 页 面 ， 分 别 输入 三 本 书 的 书 名 、 价 格 和 数量 ， 如 图 3-4 所 示 。 


3-4 订购 图 书页 面 
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单 击 界面 中 的 “订购 图 书 ” 按 钮 ， 表 单 提交 至 收集 订购 图 书信 息 界 面 showBooksjsp， 如 
图 3-5 所 示 。 


图 3-5 ”收集 订购 图 书信 息 界 面 


3.2.5 “实例 分 析 


nn 


在 上 述 案 例 的 addBookjsp 页 面 中 ，OGNL 表达 式 “#kstatus.index+1l” 是 为 了 让 索引 从 1 开 
始 ， 表 达 式 “‘books.”+‘book”+#index” 构 建 books.bookl 格式 的 字符 串 ， 文 本 输入 控件 最 终 的 
名 字 格 式 为 : books.book1l.title、books.book2.title， 以 此 类 推 。 如 果 采 用 JSP 注释 中 的 代码 ， 则 
文本 输入 控件 最 终 的 名 字 格 式 为 : books[‘book’].title…， 以 此 类 推 。 


3.3” 自 定义 类 型 转换 器 


如 果 Struts 2 内 置 的 类 型 转换 器 不 能 满足 应 用 需求 ， 还 可 以 开发 自 定义 的 类 型 转换 器 ， 以 
便于 在 不 同 的 需求 下 使 用 不 同 的 解决 方案 。 


ca 视频 教学 : 光盘 /videos/03/self-defined.avi 长 度 : 15 分 钟 
3.3.1 ”基础 知识 一 一 编写 自 定义 类 型 转换 器 


Strmts 2 已 经 实现 了 一 些 常 用 的 类 型 转换 ， 但 是 毕竟 这 些 类 型 转换 器 还 是 有 限制 的 。 如 果 
开发 者 自己 定义 数据 类 型 ， 就 必须 自 定义 类 型 转换 器 来 进行 转换 。 
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1. 基本 类 型 转换 器 


要 创建 一 个 类 型 转换 器 ， 需 要 实现 ognl.TypeConverter 接口 ， 该 接口 中 只 有 一 个 方法 ， 如 
下 所 示 。 


public abstract interface TypeConverter 

{ 
Public abstract Object convertValue (Map<String, Object> paramMap, Object 
paramObjectl1, Member paramMember, String paramString, Object paramObject2, 
Class paramClass); 


} 


由 于 该 方法 过 于 复杂 ， 所 以 在 OGNL 中 还 提供 了 一 个 工具 类 ognl.DefaultTypeConverter， 
该 类 实现 了 TypeConverter 接口 ， 并 提供 了 一 个 简单 的 converValue() 方 法 ， 如 下 所 示 。 


public class DefaultTypeConverter implements 
com.opensymphony .xwork2.conversion.TypeConverter 
{ 
public Object convertValue (Map<String, Object> context, Object value, Class 
toType) { 
return convertValue (value, toType); 


} 


} 

其 中 ，convertValue( 方 法 负责 完成 类 型 的 双向 转换 ， 为 了 实现 双向 转换 ， 通 过 判断 toType 
的 类 型 即 可 判断 转换 的 方向 ，toType 类 型 是 需要 转换 的 目标 类 型 ， 如 : 当 toType 类 型 是 User 
类 型 时 , 表明 需要 将 字符 串 转换 成 User 实例 ; 当 toType 类 型 是 String 类 型 时 , 表明 需要 把 User 
实例 转换 成 字符 串 类 型 。toType 参数 和 转换 方向 之 间 的 关系 如 图 3-6 所 示 。 


toType 为 User 类 


toType 为 String 类 


图 3-6 toType 参数 和 转换 方向 之 间 的 关系 


通过 toType 类 型 判断 了 类 型 转换 的 方向 后 ， 就 可 以 分 别 实现 两 个 方向 的 转换 逻辑 了 。 实 
现 类 型 转换 器 的 关键 就 是 实现 了 convertValue0 方 法 ， 该 方法 有 以 下 三 个 参数 。 
@ 第 一 个 参数 : context 是 类 型 转换 环境 的 上 下 文 。 
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@ 第 二 个 参数 : value 是 需要 转换 的 参数 。 随 着 转换 方向 的 不 同 ，value 参数 的 值 也 是 不 
一 样 的 ， 当 把 字符 串 类 型 向 User 类 型 转换 时 ，value 是 原始 字符 串 数 组 ; 当 需 要 把 
User 类 型 向 字符 串 类 型 转换 时 ，value 是 User 实例 。 
@ 第 三 个 参数 :toType 是 转换 后 的 目标 类 型 ， 这 个 参数 前 面 已 经 介绍 了 ， 这 里 不 袭 述 。 
convertValue0 方 法 的 返回 值 就 是 类 型 转换 后 的 值 , 该 值 的 类 型 也 会 随 着 转换 方向 的 不 同 而 
不 同 ， 当 把 字符 串 向 User 类 型 转换 时 ， 返回 值 类 型 就 是 User 类 型 ， 当 需要 把 User 类 型 向 字符 
串 类 型 转换 时 ， 返 回 值 类 型 就 是 字符 串 类 型 。 
由 此 可 见 ， 转 换 器 的 convertValue0 方 法 接收 需要 转换 的 值 ， 需 要 转换 的 目标 类 型 为 参数 ， 
然后 返回 转换 后 的 目标 值 。 
2. 基于 Struts 2 的 类 型 转换 器 


Stmts 2 提供 了 一 个 StrutsTypeConverter 的 抽象 类 ， 这 个 抽象 类 是 DefaultTypeConverter 类 
的 子 类 。 开 发 者 可 以 直接 继承 这 个 类 来 进行 类 型 转换 器 的 构造 。 通 过 继承 该 类 来 构建 类 型 转换 
器 ， 可 以 不 用 对 转换 的 类 型 进行 判断 。StrutsTypeConverter 类 的 代码 如 下 所 示 。 


public abstract class StrutsTypeConverter extends DefaultTypeConverter 
{ 


// 重 写 DefaultTypeConverter 类 的 convertValue () 方 法 
public Object convertValue (Map context, Object o, Class toClass) 
{ 
if (toClass.equals (String.class)) 
return convertToString (context, o); 
if ((o instanceof String[])) 
return convertFromString(context, (String[]) (String[])o, 
toClass); 
if ((o instanceof String)) { 
return convertFromString(context, new String[] { (String)o }, 
toClass); 
. 
return performFallbackConversion (Context，o toClass); 
} 
9 Protected Object performFallbackConversion(Map context, Object o, Class 
} toClass) 
{ 
return super.convertValue (context, o, toClass); 
} 
public abstract Object convertFromString (Map paramMap, String[] 
paramArrayOfSstring, Class paramClass); 
public abstract String convertToString (Map paramMap, Object paramObject); 
} 


StrutsTypeConverter 类 已 经 实现 了 DefaultTypeConverter 的 convertValue0) 方 法 ， 实 现 该 方 
法 时 ， 它 将 两 个 不 同 的 转换 方向 替换 成 不 同 的 方法 一 一 当 需 要 把 字符 串 转换 成 复合 类 型 时 ， 调 
用 convertFromString0 抽 象 方法 ， 当 需要 把 复合 类 型 转换 成 字符 串 时 ， 调 用 convertToStringO 
抽象 方法 。 图 3-7 展示 了 对 应 关系 。 
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convertToString0 方 法 


convertFromString0 方 法 


字符 串 类 型 


图 3-7 转换 方向 和 方向 之 间 的 对 应 关系 


实现 了 自 定义 的 类 型 转换 器 之 后 ， 要 将 类 型 转换 器 注册 到 Web 应 用 中 ，Struts 2 框架 才 可 
以 正常 使 用 该 类 型 转换 器 。 类 型 转换 器 的 注册 方式 有 三 种 : 注册 局 部 类 型 转换 器 、 注 册 全 局 类 
型 转换 器 和 使 用 注解 方式 注册 类 型 转换 器 ， 这 三 种 方式 在 前 面 一 节 中 已 经 详细 讲解 过 ， 这 里 不 
再 獒 述 。 


3.3.2 ”实例 描述 


上 小 学 的 时 候 老师 曾经 说 过 一 个 圆 在 平面 上 是 有 坐标 的 ,这 个 坐标 用 来 决定 圆 在 平面 上 的 
位 置 ， 老师 也 曾经 讲 过 一 个 圆 的 周 长 要 怎么 计算 ， 面 积 要 怎么 计算 。 而 计算 圆 的 周 长 和 面积 需 
要 知道 哪些 条 件 ? 即 知道 圆 的 半径 就 可 以 计算 出 圆 的 周 长 和 面积 。 

下 面 这 个 案例 就 帮 有 我 们 完成 了 一 个 计算 圆 的 周 长 和 面积 的 功能 。 


3.3.3 ”实例 应 用 


【 例 3-3】 计算 圆 的 周 长 和 面积 。 
(1) 在 项 目 中 新 建 com.struts2.model 包 ， 并 在 该 包 下 新 建 Point 类 ， 收 集 圆 的 坐标 信息 。 
内 容 如 下 。 
Package com.struts2.model; 
public class Point { 
Private double x;// 横 坐标 
private double y;// 纵 坐标 
/* 下 面 是 上 面 两 个 属性 的 set 、get 方法 ， 这 里 省 略 */ 
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(2) 在 com.struts2.model 包 下 新 建 Circle 类 ， 在 该 类 中 定义 圆 的 属性 ， 包 括 圆 的 半径 和 坐 
标 ， 则 需要 在 其 内 定义 一 个 Point 对 象 属性 center。 内 容 如 下 。 


Package com.struts2.model; 


public class Circle { 


private Double radius;// 圆 的 半径 
Private Point center;// 坐 标 类 Point 对 象 属性 
/* 下 面 是 上 面 两 个 属性 的 set、get 方法 ， 这 里 省 略 */ 


} 


(3) 新 建 com.struts2.converter 包 ， 并 在 该 包 下 新 建 自 定义 类 型 转换 器 类 CircleConverter. 
java。 该 类 继承 自 org.apache.struts2.util.StrutsTypeConverter 类 ， 并 重 写 了 父 类 的 convertFrom 
String(Map context，String[] values，Class toClass) 方 法 和 convertToString(Map context，Object 
value) 方 法 ， 实 现 了 类 型 转换 。 完 整 代码 如 下 。 


package com.struts2.converter; 
import java.util.Map; 
import org.apache.struts2.util.StrutsTypeConverter; 
import com.struts2.model.Circle; 
import com.struts2.model .Point; 
public class CircleConverter extends StrutsTypeConverter { 
@Override 
public Object convertFromSstring (Map context, String[] values, Class toClass) 


Circle circle=new Circle(); 
Point center=new Point(); 
String centerValues[]=values[0] .split(","); 
// 获 取 圆 的 横 坐 标 
double x=Double.parseDouble (centerValues[0]); 
// 获 取 圆 的 纵 坐标 
double y=Double.parseDouble (centerValues[1]); 
// 给 Point 坐标 类 赋值 
CenteLr .setX (X) 7 
Center .setY(Y) 
// 获 取 圆 的 半径 ， 并 直接 赋值 给 circle 类 中 的 radius 属性 
circle.setRadius (Double.parseDouble (centerValues[2])); 
// 将 已 经 赋值 的 Point 类 对 象 center 赋 给 Circle 类 中 的 Point 对 象 属性 center 
circle.setCenter (center); 
return circle; 
} 
@Override 
public String convertToString (Map context, Object value) { 
Circle circle=(Circle)value; 
return circle.toSstring(); 
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(4) 在 com.struts2.actions 包 下 新 建 CircleAction 类 ， 获 取 圆 的 信息 并 保存 。 代 码 如 下 。 


package com.struts2.actions; 

import com.opensymphony .xwork2.ActionContext; 

import com.opensymphony .xwork2.ActionSupport; 

import com.struts2.model.Circle; 

public class CircleAction extends Actionsupport { 
private Circle circle; 


Qoverride 
Public String execute () throws Exception { 
// 计 算 圆 的 周 长 
double c=2*3.14*circle.getRadius(); 
// 计 算 圆 的 面积 
double s=3.14*circle.getRadius()*circle.getRadius(); 
// 保 存 圆 的 信息 
ActionContext .getContext () .put ("message", 圆心 坐标 : 
("+circle.getCenter() .getX()+"v"+circle.getCenter() .getY ()+")---——— 圆 的 半径 : 
"+circle.getRadius()+" -----— 圆 的 周 长 : "+c+" 的 面积 "+s) ; 


return SUCCESS; 

} 

public Circle getCircle() { 
return circle; 

public void setCircle (Circle circle) { 
this.circle = circle; 


} 

(5) 在 com.struts2.actions 包 下 新 建 CircleAction-conversion.properties 文件 ， 将 类 型 转换 器 
注册 到 Web 应 用 程序 中 。 该 文件 只 有 一 行 代码 ， 如 下 所 示 。 

circle=com.struts2.converter.CircleConverter 


(6) 在 WebRoot 下 新 建 createCircle.jsp 页 面 ， 可 以 输入 圆 的 横 坐 标 、 纵 坐标 和 半径 的 一 个 
表单 页 面 。 关 键 代 码 如 下 。 
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<%@taglib prefix="s" uri="/struts-tags" 对 > 
请 分 别 输入 圆 的 横 坐 标 、 纵 坐标 、 半 径 
<s:form action="convert/circle.action" method="post"> 
<table align="center" border="0" width="400"> 
<tr ><td colspan="2"><font color="#3737DE"></font></td></tr> 
<tr> 
<td><input type="text" name="circle"/></td> 
<td><font color="red">x,y,radius</font></td> 
</tr> 
<tr><td colspan="3" align="center"><s:submit 
value="submit"/></td></tr> 
</table> 
</s:form> 


第 3 章 数据 类 型 大 转换 | 


<E@— 


< 2 Web 开发 学 习 实录 .入 


(7) 创建 circleMessage.jsp 页 面 ， 获 取 圆 的 信息 并 和 输出。 关键 代码 如 下 。 


<s@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<%@taglib prefix="s" uri="/struts-tags" $%> 


<s:property value="message"/> 


上 面 代 码 的 <s:property> 标 签 中 的 value 值 ， 是 在 CircleAction 类 的 execute0 方 法 中 保存 在 
ActionContext 中 的 message 值 ， 故 在 这 里 直接 调用 “message” 就 可 得 到 Value 的 值 。 
(8) 在 struts.xml 文件 中 配置 CircleAction 类 ， 代 码 如 下 。 
<package name="convert" namespace="/convert" extends="struts-default"> 
<action name="circle" class="com.struts2.actions.CircleAction"> 
<result name="success">/circleMessage.jsp</result> 
</action> 
</package> 


3.3.4 运行 结果 


运行 createCircle.jsp 页 面 ， 在 文本 框 中 输入 “100,200,300”， 如 图 3-8 所 示 。 
单 击 submit 按钮 ， 提 交 至 circleMessage.jsp 页 面 ， 输 出 圆 的 信息 ， 如 图 3-9 所 示 。 


图 3-8 定义 圆 界 面 图 3-9 输出 圆 的 信息 界面 


3.3.5 ”实例 分 析 


总 wa 


在 上 述 例子 的 CircleConverter 转换 器 类 中 ， 重 写 了 org.apache.struts2.util.StrutsType 
Converter 类 的 convertFromString(Map context, String[] values, Class toClass) 方 法 , 在 该 方法 中 获 
取 到 了 表单 元 素 中 以 过 号 隔 开 的 三 个 值 : 圆 的 横 坐 标 、 圆 的 纵 坐 标 和 圆 的 半径 ， 并 分 别 赋 给 了 
Point 类 中 的 x 属性 、y 属性 和 Circle 类 中 的 radius 属性 ， 从 而 在 CircleAction 中 调用 Circle 中 
的 属性 和 了 Point 中 的 属性 即 可 计算 出 圆 的 周 长 和 面积 。 
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3.4 ”类 型 转换 中 的 异常 处 理 


在 JSP 文件 中 提供 用 户 输入 信息 ， 而 偶然 或 者 恶意 的 输入 错误 ， 都 会 导致 程序 出 现 异 常 。 


因此 ， 必 须 对 用 户 输入 的 数据 进行 校 验 ， 例 如 日 期 校 验 、 整 数 校 验 和 字符 串 长 度 校 验 等 。 本 节 
要 介绍 的 是 数据 在 类 型 转换 时 的 校 验 。 例 如 出 生日 期 必须 是 日 期 类 型 ， 但 用 户 却 输入 非 日 期 类 
型 字符 串 数 据 ， 这 时 就 需要 进行 数据 类 型 转换 的 异常 处 理 。 


3.4.1 基础 知识 


. 
视频 教学 ， 光 盘 /videos/03/build-in.avi 人 @@ 长 度 : 11 分 名 


类 型 转换 中 的 异常 处 理 


表现 层 数据 是 由 用 户 输入 的 ， 用 户 输入 的 信息 是 非常 复杂 的 ， 用 户 的 偶然 错误 或 者 是 


Cracker( 破 坏 者 ) 的 恶意 输入 ， 都 可 能 导致 系统 出 现 非 正常 的 情况 。 实 际 上 ， 表 现 层 数据 涉及 的 
数据 校 验 和 类 型 转换 两 个 处 理 是 紧密 相关 的 ， 只 有 当 输 入 数据 是 有 效 数 据 时 ， 系 统 才 可 以 进行 
有 效 的 类 型 转换 。 当 然 ， 有 时 候 即 使 用 户 输入 的 数据 能 进行 有 效 转 换 ， 但 依然 是 非法 数据 ( 假 
设 需要 输入 一 个 人 的 年 龄 ， 输 入 200 则 肯定 是 非法 数据 )。 因 此 ， 进 行 有 效 的 类 型 转换 是 基础 ， 
只 有 当 数 据 完成 了 有 效 的 类 型 转换 后 ， 下 一 步 才 去 做 数据 校 验 。 


1. 类 型 转换 异常 拦截 器 
Stmts 2 提供 类 型 转换 异常 处 理 机 制 ， 它 提供 名 称 为 conversionError 的 拦截 器 ， 这 个 拦截 


器 被 注册 在 默认 拦截 器 栈 中 。 如 果 Struts 2 在 类 型 转换 过 程 中 出 现 异 常 ， 那 么 该 拦截 器 就 会 进 
行 拦截 ， 并 将 异常 信息 封装 成 一 个 fieldError， 然 后 在 视图 页 面 上 显示 出 来 。 


》 Stmuts 2 提供 类 型 转换 异常 处 理 机 制 , 整个 过 程 无 需 开 发 者 参与 ，Struts 2 的 类 型 转 
提示 换 器 和 conversionError 拦截 器 会 自动 实现 。 


查看 Struts 2 框架 的 默认 配置 文件 struts-default.xml， 该 文件 中 有 如 下 配置 片段 。 


<interceptor name="conversionError™" 
class="org.apache.struts2.interceptor.StrutsConversionErrorInterceptor"/> 
<interceptor-stack name="defaultstack"> 


<!-- 省 略 其 他 拦截 器 引用 --> 
<1- -处 理 类 型 转换 错误 的 拦截 器 -> 


<interceptor-ref name="conversionError"/> 
<!- -处理 数 据 校 验 的 拦截 器 --> 
<interceptor-ref name="validation"> 
<param name="excludeMethods">input,back,cancel,browse</param> 
</interceptor-ref> 
<!-- 省 略 其 他 拦截 器 --> 


</interceptor-stack> 


<E@—— 
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从 上 面 的 配置 中 可 以 看 出 ， 在 struts-default.xml 文件 中 定义 了 conversionError 拦截 器 ， 类 
型 是 org.apache.struts2.interceptor.StrutsConversionErrorInterceptor， 这 个 拦截 器 已 被 包含 在 
defaultStack 拦截 器 栈 中 。 


外 » org.apache.struts2.interceptor.StrutsConversionErrorInterceptor 拦截 器 继承 自 Conversion 

入 由 ErrorInterceptor 类 ， 它 只 在 字段 值 不 是 null、 不 是 “ ”或 者 不 是 { “ ”}( 表 示 只 
有 一 个 空 字符 串 元 素 的 字符 串 数组 ) 的 情况 下 ， 才 会 把 转换 错误 从 ActionContext 
添加 到 Action 的 字段 错误 中 。 这 在 Web 环境 下 是 有 用 的 。 


如 果 Struts 2 类 型 转换 器 执行 类 型 转换 时 出 现 错误 ， 上 述 conversionError 拦截 器 负责 将 对 
应 错误 封装 成 表单 域 错误 (fieldError)， 并 将 这 些 错误 信息 放 入 ActionContext 中 。 图 3-10 显示 
了 Stmts 2 类 型 转换 中 的 错误 处 理 流程 。 


客户 端 浏览 者 | 


| 
发 送 请 求 1 | 
1 


发 送 类 型 转换 结束 后 的 请 求 参数 


1 1 1 
图 3-10 Struts 2 类 型 转换 的 错误 处 理 流程 


在 图 3-10 中 只 显示 了 类 型 转换 器 、conversionError 拦截 器 和 控制 器 之 间 的 顺序 图 ， 并 未 完 
全 刻画 出 系统 中 的 其 他 成 员 。 当 conversionError 拦截 器 对 转换 异常 进行 处 理 后 ， 系 统 会 跳 转 到 
名 为 input 的 逻辑 视图 。 
@ ” 必须 指出 的 是 , 为 了 让 Struts 2 框架 处 理 类 型 转换 的 错误 ,以 及 使 用 后 面 的 数据 校 


注意 验 机 制 ， 系 统 的 Action 类 都 应 该 通过 继承 ActionSupport 类 来 实现 。ActionSupport 
类 为 完成 类 型 转换 错误 处 理 ， 数 据 校 验 实现 了 许多 基础 工作 。 


2. 处 理 类 型 转换 错误 

下 面 将 以 一 个 最 简单 的 局 部 类 型 转换 器 为 例 ， 介 绍 如 何 处 理 类 型 转换 的 错误 。 

重新 创建 一 个 Action 类 ， 让 系统 的 Action 类 继承 Struts 2 的 ActionSupport 类 。 内 容 如 下 。 
// 为 了 正常 使 用 系统 的 类 型 转换 错误 处 理 机 制 ， 让 Action 类 继承 Actionsupport 类 


Public class UserAction extends ActionSupport 
{ 


Private User user; 
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KE 


private String tip; 
/* 下 面 是 上 面 两 个 属性 的 set、get 方法 ， 这 里 省 略 */ 
// 省 略 execute () 方 法 


} 


当 类 型 转换 异常 时 ，conversionError 拦截 器 会 处 理 该 异常 ， 然 后 转 入 名 为 input 的 逻辑 视 
图 ， 因 此 应 该 为 该 Action 增加 名 为 input 的 逻辑 视图 定义 。 在 struts.xml 文件 中 配置 如 下 。 
<struts> 
<!-- 配置 struts 2 的 包 空间 --> 
<package name="user" extends="struts-default"> 
<!-- 定义 处 理 用 户 请 求 的 Action --> 
<action name="user" class="com.struts2.actions.UserAction"> 
<!-- 配置 名 为 input 的 逻辑 视图 ， 当 校 验 失败 后 转 入 该 逻辑 视图 --> 
<result name="input">/input.jsp</result> 
<!-- 配置 名 为 success 的 逻辑 视图 --> 
<result name="success">/success.jsp</result> 
</action> 
</package> 
</struts> 
经 过 上 面 的 配置 , 如 果 用 户 输入 信息 不 能 成 功 转换 成 用 户 实例 , 系统 将 转 入 inputjsp 页 面 ， 
等 待 用 户 再 次 输入 。 
3. 输出 类 型 转换 错误 
当 类 型 转换 处 理 失败 后 ， 系 统 将 进入 名 为 input 的 逻辑 视图 ， 但 在 该 页 面 没有 任何 提示 ， 
这 样 让 用 户 会 感到 疑惑 。 
前 面 已 经 讲述 过 ，conversionError 会 负责 将 转换 错误 封装 成 fieldError， 并 将 其 放 在 Action 
Context 中 。 为 了 在 input 视图 对 应 的 页 面 中 输入 转换 错误 ， 只 需要 在 页 面 中 使 用 <s:fielderror/> 
标签 即 可 输出 该 类 型 转换 错误 信息 。 图 3-11 显示 了 类 型 转换 出 错 信息 的 页 面 。 


3-11 显示 类 型 转换 错误 的 界面 


<@—— 
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正如 图 3-11 所 显示 的 ， 当 某 个 Field 类 型 转换 失败 后 ， 将 出 现 “Invalid field value for field 
xxx” 的 错误 信息 ， 其 中 “xxx” 是 Action 中 的 属性 名 ， 也 是 该 属性 对 应 的 请 求 参数 的 名 。 对 于 
中 文 环境 而 言 ， 通 常 希望 看 到 中 文 的 提示 信息 ， 因 此 应 该 在 应 用 中 改变 该 提示 信息 。Struts 2 
允许 改变 类 型 转换 失败 后 的 错误 提示 信息 , 只 要 在 应 用 的 国际 化 资源 文件 中 增加 如 下 一 行 代码 
即 可 。 


# 改 变 默认 的 类 型 转换 失败 后 的 错误 提示 信息 
xwork.default.invalid.fieldvalue={0} 字 段 类 型 转换 失败 ! 


由 于 上 面 资源 文 件 中 包含 了 非 西 欧 字 符 ， 因 此 必须 使 用 native2ascii 命令 来 处 理 该 
到 示 | ”文件 的 非 西欧 字符 . 

上 面 资源 项 中 的 xwork.default.invalid .fieldvalue.key 改变 提示 信息 的 key， 而 后 面 的 信息 则 
是 用 户 希望 在 页 面 中 显示 的 提示 信息 。 某 些 时 候 , 可 能 还 需要 对 特定 字段 指定 特定 的 提示 信息 ， 
此 时 可 以 提供 该 Action 的 局 部 资源 文件 ， 局 部 资源 文件 的 文件 名 命名 如 下 。 

ClassName.Properties 

在 该 文件 中 增加 如 下 一 项 。 

# 为 某 个 Action 特定 属性 指定 特定 的 转换 失败 提示 信息 

invalid.fieldvalue. 属 性 名 = 提示 信息 

其 中 “invalid.fieldvalue” 部 分 是 固定 的 ， 而 “属性 名 ”是 Action 中 的 属性 名 ， 也 是 请 求 参 
数 名 , 该 项 的 value 就 是 指定 的 类 型 转换 失败 提示 信息 , 该 信息 在 页 面 中 的 显示 可 以 自 定义 CSS 
样式 来 设置 。 


3.4.2 ”实例 描述 


-个 公司 的 内 部 管理 系统 中 ， 一 般 都 会 有 用 户 管理 这 个 模块 ， 这 个 模块 可 用 于 将 刚 进入 公 
司 的 人 注册 成 为 管理 系统 的 用 户 。 有 时 候 因 为 公司 业务 繁忙 ， 需 要 招 进 一 大 批 的 人 才 ， 此 时 一 
条 一 条 地 添加 新 招 人 才 信 息 是 很 麻烦 的 事 。30 条 信息 还 可 以 应 付 ， 对 于 一 个 大 公司 来 说 ， 招 聘 
| 80 个 人 也 是 很 有 可 能 的 ， 那 么 也 要 一 条 一 条 地 添加 这 80 个 人 的 信息 吗 ? 这 是 不 是 意味 着 管理 
员 还 需要 是 一 个 身 强 体 壮 的 人 呢 ? 答案 是 不 需要 的 ， 我 们 可 以 一 次 性 添加 多 条 信息 。 
下 面 这 个 例子 就 为 公司 内 部 管理 系统 解决 了 这 个 信息 繁多 的 问题 ! 


3.4.3 ”实例 应 用 


【 例 3-4】 采用 集合 转换 错误 处 理 实现 多 个 用 户 同时 注册 功能 。 
(1) 在 com.struts2.model 包 下 新 建 实体 类 User.java, 它 有 三 个 属性 : username、age 和 birth， 
分 别 表示 用 户 的 用 户 名 、 年 龄 和 出 生日 期 。 代 码 如 下 。 
Package com.struts2.model; 


import java.util.Date; 
[三文 


Eee > 
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* 用 户 类 
* @author Rdministrator 
守 
wh 
public class User { 
private String username;// 用 户 名 
private int age;// 年 龄 
private Date birth;// 出 生日 期 
/* 下 面 是 上 面 三 个 属性 的 set、get 方法 ， 这 里 省 略 */ 
} 


(2) 在 com.struts2.actions 包 下 新 建 UserAction 类 , 它 有 一 个 集合 属性 user, 并 定义 了 该 集 
合 元 素 类 型 为 user。UserAction 类 的 内 容 如 下 。 


Package com. struts2.actions7 
import java.util.List; 
import com.opensymphony.xwork2.ActionSupport; 
import com.struts2.model .User; 
public class UserAction extends ActionSupport { 
// 以 一 个 List 属性 来 封装 一 个 字符 串 请 求 参数 
private List<User> user; 
/a 
* 处 理 用 户 请 求 的 execute () 方 法， 直接 返回 success 字符 串 
be 
public String execute() throws Exception { 
return SUCCESS; 
1 
public List<User> getUser() { 
return user; 
} 
public void setUser (List<User> user) { 
this.user = user; 


} 
(3) 在 com.struts2.converter 包 下 新 建 转换 器 类 一 一 UserConverter.java， 内 容 如 下 。 


package com.struts2.converter; 
import java.text.ParseException; 
import java.text.SimpleDateFormat; 
import java.util.ArrayList; 
import java.util.List; 
import java.util.Map; 
import org.apache.struts2.util.SsStrutsTypeConverter; 
import com.struts2.model .User; 
J/*# 
* 用 户 注册 类 型 转换 器 


* @author Administrator 


<B— 


ts 人 web 开发 学 习 实录 


public class UserConverter extends StrutsTypeConverter { 
// 实 现 从 String 类 型 转换 成 复合 类 型 的 方法 


public Object convertFromstring (Map context, String[] values, Class toClass) 


SimpleDateFormat sdf=new SimpleDateFormat ("yyyy-MM-dd"); 
// 如 果 添 加 了 多 个 用 户 的 信息 
if (values.length > 1) 
{ 
// 定 义 一 个 List 集合 
List<User> result = new ArrayList<User>(); 
// 循 环 遍历 多 个 用 户 的 信息 
for (int i = 0; i < values.length; i++) 
和 
User user = new User(); 
// 把 表单 的 每 个 元 素 的 值 以 逗号 分 开 ， 并 组 成 一 个 数组 
String[] userValues = values[i].split(","); 
// 把 相应 的 表单 元 素 值 赋 值 给 User 类 中 的 属性 
user.setUsername (userValues[0]); 
user.setAge (Integer.parseInt (userValues[1])); 
try { 
user.setBirth(sdf.parse(values[2])); 
} catch (ParseException e) { 
e.printstackTrace (); 
} 
// 把 赋值 后 的 User 类 添加 至 集合 中 
result.add (user); 
1 
// 返 回 集合 
Ieturn result; 
} 
// 如 果 只 添加 了 一 个 用 户 的 信息 ， 或 没有 添加 一 个 用 户 的 信息 ， 把 表单 元 素 的 值 赋 给 User 
类 中 的 属性 ， 并 返回 User 类 对 象 
User user = new User(); 
String[] userValues = values[0] .split(","); 
user.setUsername (userValues[0]); 
user.setAge (Integer.parseInt (userValues[1])); 
try € 
user.setBirth(sdf.parse (values[2])); 
} catch (ParseException e) { 
e.printstackTrace (); 
} 
return user; 
} 
// 实 现 从 复合 类 型 转换 成 string 类 型 
public String convertToString (Map context, Object o) { 


// 如 果 复 合 类 型 是 User 类 型 


m= >> 
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if ((o instanceof User)) 
丰 
User user = (User)o; 
return "< 用 户 名 : " + user.getUsername () + ", 年 龄 : " + user.getAge() 
EE 
’ 
// 如 果 复 合 类 型 为 List 类 型 
if ((o instanceof List)) 
{ 
List<User> users = (List<User>)o; 
String result = "["™; 
for (User user : users) 
a 


result = result + "< 用 户 名 : " + user.getUsername () + "年 龄 : " + 
user.getAge() + ">"; 
return result + "]"; 
} 


return nn 


} 


(4) 创建 了 类 型 转换 器 类 之 后 ， 需 要 把 类 注册 到 Web 应 用 程序 中 ， 在 这 里 使 用 全 局 类 型 
转换 器 注册 方式 来 注册 ， 即 在 sre 目录 下 新 建 xwork-conversion.properties 文件 ， 内 容 如 下 。 
# 所 有 包含 com. struts2 .model .User 类 的 Action 都 使 用 


com. struts2.converter.UserConverte 转换 器 
com.struts2.model .User=com.struts2.converter.UserConverter 


定义 了 这 样 的 内 容 后 , 当 Web 程序 中 的 任何 一 个 Action 类 中 包含 了 com.struts2.model.User 
对 象 时 ,都 会 使 用 com.struts2.converter.UserConverter 转换 器 来 对 表单 输入 数据 进行 String 与 复 
合 类 型 的 转换 。 

(5) 创建 国际 化 资源 文件 ， 改 变 类 型 转换 失败 信息 。 在 sre 目录 下 新 建 globalMessages. 
properties 文件 ， 该 文件 是 英文 环境 下 要 使 用 的 国际 化 资源 文件 。 内 容 如 下 。 

# 改 变 默认 的 类 型 转换 失败 后 的 提示 信息 


xwork.default.invalid.fieldvalue={0}invalid field value for field! 


(6) 接着 在 src 目录 下 新 建 中 文 环 境 下 的 国际 化 资源 文件 (globalMessages_zh_CN properties)， 
内 容 如 下 。 


xwork.default.invalid.fieldvalue= {0} 字 段 类 型 转换 失败 ! 


(7) 在 struts.xml 文件 中 配置 程序 的 国际 化 资源 文件 和 UserAction 类 ， 配 置 如 下 。 
<!-- 通过 常量 配置 struts2 所 使 用 的 解码 集 --> 


<constant name="struts.il8n.encoding" value="gbk" /> 

<constant name="struts.devMode" value="true" /> 

<constant name="struts.custom.il8n.resources" value="globalMessages"/> 
<package name="convert" namespace="/convert" extends="struts-default"> 
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<action name="user" class="com.struts2.actions.UserAction"> 
<result name="input">/inputUser.jsp</result> 
<result name="success">/index.jsp</result> 
</action> 
</package> 


1 $ 。” 当 conversionError 拦截 器 拦截 到 类 型 转换 失败 后 ， 系 统 将 跳 转 至 “input” 还 辑 视 


各 千 | 图 ， 故 这 里 配置 的 “input” 的 Result 不 可 少 。 
(8) 在 WebRoot 下 新 建 inputUserjsp 页 面 , 用 于 录入 用 户 信息 , 每 次 最 多 可 注册 三 个 用 户 
的 信息 ， 代 码 如 下 。 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 


<%@taglib prefix="s" uri="/struts-tags" 名 > 
<s-- 类 型 转换 失败 提示 信息 --#> 
<s:fielderror /> 
<form action="convert/user.action"” method="post"> 
<table align="center" width="360"> 
<tr align="center"> 
<td style="font-size: 12px; "> 请 分 别 输 入 三 个 用 户 的 用 户 名 、 年 龄 、 出 生日 期 ， 
以 逗号 隔 开 </td> 
</tr> 
<s:iterator value="new int[3]" status="stat"> 
<tr> 
<td> 
第 <s:property value="%{#stat .index+1}"/> 个 用 户 信 息 
<input name='user' type="text"/> 
</td> 
</tr> 
</s:iterator> 
<tr align="center"> 
<td><input type="submit" value=" 确 定 "/><input type="reset" value=" 
重 设 "/></td> 
</tr> 
</table> 
<form> 


(9) 在 WebRoot 下 新 建 用 户 注册 成 功 页 面 suecess.jsp, 并 在 页 面 中 输出 新 注册 的 用 户 信息 ， 
使 用 <s:property .… 人 > 标签 即 可 输出 用 户 信息 。 


3.4.4 运行 结果 


运行 inputUser.jsp 页 面 ， 当 输入 的 信息 不 符合 “String,int,Date” 格 式 的 类 型 数据 时 (如 
图 3-12 所 示 )， 提 交 表 单 后 还 是 跳 转 到 这 个 页 面 ， 并 提示 类 型 转换 失败 信息 ， 如 图 3-13 所 示 。 


mt >> 
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3.4.5 ”实例 分 析 


ns 


在 上 面 的 例子 中 ，inputUser.jsp 页 面 定义 了 三 个 user 的 请 求 参 数 ， 但 是 服务 器 只 会 接受 一 
个 名 为 user 的 请 求 参 数 ， 该 请 求 参 数 的 值 是 一 个 字符 串 数组 。 在 UserAction 类 中 使 用 了 泛 型 
来 限制 集合 元 素 的 类 型 ， 因 此 系统 的 类 型 转换 器 会 作用 于 该 Action 的 user 属性 ， 如 果 用 户 的 
输入 不 能 正确 转换 成 对 应 的 类 型 ， 则 conversionError 拦截 器 会 起 作用 ， 故 当 类 型 转换 失败 后 会 
提示 如 图 3-13 所 示 的 错误 信息 。 


/lseslhest SOBU/Strataz Genourtar /nts 
立 伞 四 “二 机 加， 可 看 收 庆 天 公 工具 GD) 帮助 t 
帘 窑 | 大 用 PE 于 


b 和 和、 » 户 人 筷 
ne 了 概 家 多 入 1 
第 2 个 用 户 信息 [zhongh 25.1995-04.04 请 3 和 二 个 风 忆 的 用 户 各 生硬 、 出 生日 类 ， 吕 开 
第 3 个 用 户 信息 [wanggang 26 wanggang 第 1 个 用 户 信息 
| 第 2 个 用 户 信息 
< 第 3 个 用 户 信息 


图 3-12 录入 无 效 信息 图 3-13 ”类 型 转换 失败 提示 信息 


3.5 ”使 用 类 型 转换 注解 


作为 ClassName-conversion.properties 文件 的 奉 代 ， 可 以 使 用 Struts 2 提供 的 类 型 转换 注解 
来 配置 类 型 转换 器 。 这 一 节 将 介绍 Struts 2 中 使 用 类 型 转换 注解 的 相关 知识 。 


. 
EE 视频 教学 ， 光 盘 /videos/03/zhujie.avi 人 @ 长 度 : 15 分钟 


3.5.1 基础 知识 使 用 类 型 转换 注解 


Struts 2 中 用 于 类 型 转换 的 注解 共有 6 个 ， 如 下 所 示 。 


ES | 
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TypeConversion 
Conversion 
Element 

Key 
KeyProperty 
CreateIfNull 


i 


TypeConversion 注解 
TypeConversion 注解 应 用 于 属性 和 方法 级 别 ， 它 的 参数 如 表 3-1 所 示 。 
表 3-1 TypeConversion 注解 的 参数 


描 述 
指定 要 转换 的 属性 名 或 类 名 ， 依 赖 于 


key String 


e ConversionT 
en APPLICATION 或 者 CLASS 


ConversionRule 的 枚 举 值 ， 可 以 是 

PROPERTY、KEY、KEY_ PROPERTY、 
ELEMENT、COLLECTION( 已 被 弃 ) 或 
者 MAP 
指定 用 作 转 换 器 的 TypeConverter 实现 
类 的 类 名 。 这 个 参数 不 能 和 Conversion 
Rule.KEY_PROPERTY 一 起 使 用 
和 ConversionRule PROPERTY 一 起 使 
用 时 ,指定 一 个 值 , 如 果 使 用 Conversion 
Type.APPLICATION， 则 不 能 使 用 这 个 
参数 


TypeConversion 注解 可 以 指定 类 范围 转换 或 者 应 用 程序 范围 转换 的 规则 。 

1) ”类 范围 转换 

设置 type 为 : type=ConversionType.CLASS, 转换 规则 将 从 一 个 名 为 ClassName-conversion. 
properties 文件 中 转 配 ， 该 文件 和 其 相关 的 Action 类 在 同一 个 包 中 。 

2) ”应 用 程序 范围 转换 

设置 type 为 : type=ConversionType.APPLICATION, 转换 规则 将 从 xwork-conversion.properties 
文件 中 装配 ， 该 文件 位 于 CLASSPATH 的 根 路 径 下 。 

下 面 使 用 TypeConversion 注解 来 配置 用 户 注册 程序 中 的 日 期 类 型 转换 器 ， 编 辑 Userjava， 
在 setBirth0 方 法 上 使 用 TypeConversion 注解 ， 代 码 如 下 所 示 。 


mle ConversionRule “| 否 


和 value 参数 
任 选 其 一 


converter |String 


和 converter 参 


value String 数 任 选 其 一 


/7 应 用 程序 范围 转换 


@TypeConversion( 


ml > 
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type=ConversionType.APPLICATION, 
key="java.util.Date", 
converter="com.struts2.converter .DateTypeConverter" 


) 
// 应 用 类 范围 转换 
@TypeConversion( 
type=ConversionType.CLASS, // 可 以 省 略 
key="birth",// 可 以 省 略 
converter="com.struts2.converter .DateTypeConverter™" 
) 
public void setBirth(Date birth) { 
this.birth = birth; 
} 


2. Conversion 注解 


Conversion 注解 可 以 让 类 型 转换 应 用 到 类 型 (TYPE) 级 别 ， 即 可 以 应 用 到 类 、 接 口 (包括 注 
解 类 型 或 枚 举 声 明 。Conversion 注解 只 有 一 个 参数 ， 如 表 3-2 所 示 。 
表 3-2 ”Conversion 注解 的 参数 


| 类 型 | 是 Ew 需 | 默认 值 


TypeConversion[] 


允许 类 型 转换 被 应 用 到 
类 型 (TYPE) 级 别 


在 User 类 上 使 用 Conversion 注解 来 配置 日 期 类 型 转换 器 ， 代 码 如 下 。 
// 使 用 conversion 注解 


@Conversion( 
// 指 定 conversions 参数 
conversions= 


{ 


conversions 


// 使 用 Typeconversion 注解 

@TypeConversion( 
type=ConversionType.CLASS, 
key="birth", 
converter="com.struts2.converter.DateTypeConverter" 


} 
) 


public class User implements Serializable 
3. Element 注解 


Element 注解 用 于 指定 Collection 或 Map 中 的 元 素 类 型 , 该 注解 只 能 用 于 字段 或 方法 级 别 。 
Element 注解 只 有 一 个 参数 ， 如 表 3-3 所 示 。 


< 人 mm 
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表 3-3 Element 注解 的 参数 


java.lang.Object.class 指定 Collection 或 Map 中 的 元 素 类 型 


Element 注解 用 于 替代 ClassName-conversion.properties 文件 中 的 Element xxx 的 配置 ， 代 
码 如 下 。 


// 指 定 List 元 素 类 型 为 com. struts2.model.User 类 
@Element (com.struts2.model .User.class) 


private List users; 

// 指 定 Map 元 素 类 型 为 com. struts2.model.User 类 
@Element (com.struts2.model .User.class) 
private Map users; 


全 | 在 J2SE5.0 以 后 的 版 本 中 ， 可 以 直接 使 用 泛 型 技术 来 指定 元 素 的 类 型 。 


注意 


4. Key 注解 


Key 注解 用 于 指定 Map 中 的 key 的 类 型 ,该 注解 只 能 用 于 字段 或 方法 级 别 。Key 注解 只 有 
-个 参数 ， 如 表 3-4 所 示 。 


表 3-4 ”Key 注解 的 参数 


参数 | 类 型 | 是 Ew 需 | 默认 值 | 


java.lang.Object.class 指定 Map 中 的 key 的 类 型 


Key 注解 用 于 替代 ClassName-conversion.properties 文件 中 的 Key_xxx 的 配置 ,代码 如 下 所 示 。 


// 指 定 Map 元 素 类 型 为 com. struts2.model.User 类 
@Element (com.struts2.model .User.class) 

// 指 定 Map 中 的 key 类 型 为 java .lang.String 类 型 
@Key (java.lang.String.class) 

private Map users; 


全 | 在 J2SE5.0 以 后 的 版 本 中 ， 可 以 直接 使 用 泛 型 技术 来 指定 Map 中 的 key 的 类 型 


5. KeyProperty 注解 


KeyProperty 注解 指定 用 于 索引 集合 元 素 的 属性 名 ， 该 注解 只 能 用 于 字段 或 方法 级 别 ， 
KeyProperty 注解 只 有 一 个 参数 ， 如 表 3-5 所 


表 3-5 KeyProperty 注解 的 参数 


参 数 类 型 是 否 必需 默认 值 描 述 
value String 否 id 指定 用 于 索引 集合 元 素 的 属性 名 


m= >> 
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KeyProperty 注解 用 于 替代 ClassName-conversion.properties 文件 中 的 KeyProperty_xxx 的 配 
代码 如 下 。 

// 指 定 Set 集合 中 的 元 素 类 型 为 com.struts2.model.User 类 

@Element (com. struts2.model.User.class) 

// 指 定 set 集合 索引 为 User 类 型 的 username 属性 

@KeyProperty ("username") 

Private Set users=new LinkedHashSet (); 


6. CreatelfNull 注解 
CreateIfNull 注解 指定 在 引用 的 集合 元 素 为 null 时 ， 是 否 让 框架 创建 它 。 该 注解 只 能 用 于 


字段 或 方法 级 别 。CreateIfNull 注解 只 有 一 个 参数 ， 如 表 3-6 所 示 。 


表 3-6 ”CreatelfNull 注解 的 参数 


| 类 型 | 是 必需 | 默认 值 | 描述 


oolean 时 ， 是 否 让 框架 创建 它 


CreateIfNull 注解 用 于 替代 ClassName-conversion.properties 文件 中 的 CreateIfNull_xxx 的 配 


， 代 码 如 下 。 


// 指 定 set 集合 中 的 元 素 类 型 为 com. struts2.model.User 类 
@Element (com.struts2.model .User.class) 

// 指 定 Set 集合 中 的 访问 索引 为 User 类 中 的 username 属性 名 
@KeyProperty ("username") 

// 指 定 引用 Set 集合 元 素 为 null 时 ， 让 框架 创建 它 
@CreateIfNul]l (true) 

private Set users=new LinkedHashSet (); 


3.5.2 ”实例 描述 


大 家 应 该 都 有 在 不 同 的 系统 中 注册 一 个 属于 自己 账号 的 经 验 吧 ! 那么 当 我 们 在 年 龄 输入 框 


中 输入 几 个 英文 字母 , 或 是 在 出 生日 期 的 输入 框 中 输入 非 日 期 格式 的 字符 ,将 会 出 现 什 么 样 的 
结果 呢 ? 或 许 通 过 前 面 章 节 的 讲解 ， 这 些 错误 都 可 以 得 以 解决 ， 那 么 ， 如 何 使 用 类 型 转换 的 注 
解 方式 来 实现 用 户 注册 功 能 呢 ? 下 面 来 做 一 下 吧 ! 


3.5.3 ”实例 应 用 


【 例 3-5】 运用 类 型 转换 注解 方式 实现 用 户 注册 功能 。 
(1) 在 com.struts2.model 包 下 新 建 User.java 类 ， 它 有 三 个 属性 ， 分 别 是 usemame、age、 


birth， 并 有 相应 的 set、get 方法 。 在 此 直接 使 用 3.4.4 节 案 例 中 的 Userjava 类 。 


<@— 
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(2) 在 com.struts2.converter 包 下 新 建 整数 类 型 转换 器 类 一 一 IntegerTypeConverter.java, 代 
码 如 下 。 


package com.struts2.converter; 


import java.util.Map; 

import org.apache.struts2.util.SstrutsTypeConverter; 

import com.opensymphony.xwork2.conversion.TypeConversionException; 
大 

* 整数 类 型 转换 器 

* @author Administrator 

六 

二 

public class IntegerTypeConverter extends StrutsTypeConverter { 


// 把 表单 元 素 中 输入 的 字符 串 类 型 转换 成 整数 类 型 
public Object convertFromString (Map context, String[] values, Class toClass) 
{ 
,se 
return Integer.parseInt (values[0]); 
} catch (Exception e) { 
// 当 解析 出 现 异常 时 ， 抛 出 TypeConversionException 异常 ， 以 通知 Struts 2 
发 生 了 转换 错误 
throw new TypeConversionException( 
e.getMessage ()+"["+values+"-class:"+toClass+"]" 


} 

// 把 表单 元 素 中 输入 的 复合 类 型 转换 成 字符 串 类 型 

public String convertToString (Map context, Object o) { 
return o.tostring(); 


} 


? (3) 在 com.struts2.converter 包 下 新 建 日 期 格式 类 型 转换 器 类 一 一 DateTypeConverter. java， 
代码 如 下 。 
package com.struts2.converter; 
import java.text.SimpleDateFormat; 
import java.util.Map; 
import org.apache.struts2.util.StrutsTypeConverter; 
import com.opensymphony .xwork2.conversion.TypeConversionException; 
public class DateTypeConverter extends StrutsTypeConverter { 
// 定 义 日 期 格式 
private static SimpleDateFormat sdf=new SimpleDateFormat ("yyyy-MM-dd"); 


// 把 表单 元 素 输入 的 字符 串 类 型 转换 成 日 期 格式 类 型 
public Object convertFromString (Map context, String[] values, Class toClass) 


{ 
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try { 

// 使 用 指定 的 日 期 格式 解析 字符 串 值 ， 返 回 Date 对 象 

return sdf.parse(values[0]): 

} catch (Exception e) { 

// 当 解析 出 现 异 常 时 ， 抛 出 TypeConversionException 异常 ， 以 通知 Struts 2 
发 生 了 转换 错误 

throw new TypeConversionException( 

e.getMessage()+"["+values+"-class:"+toClass+"]" 
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// 把 表单 元 素 输入 的 复合 类 型 转换 成 字符 串 类 型 

public String convertToString (Map context, Object o) { 
// 使 用 指定 的 日 期 格式 化 Date 对 象 ， 返 回 字符 串 


return sdf.format (o) 7 


(4) 修改 User 类 ， 指 定 age 属性 和 birth 属性 要 加 载 的 类 型 转换 器 。 完 整 代码 如 下 。 


Package com.struts2.model; 
import java.io.Serializable; 
import java.util.Date; 


import com.opensymphony.xwork2.conversion.annotations.TypeConversion; 
/** 


* 用 户 类 

* @author Administrator 

四 

入 六 

public class User implements Serializable { 
private String username;// 用 户 名 
private int age;// 年 龄 


private Date birth;// 出 生日 期 

public String getUsername() { 
return username; 

} 

public void setUsername (String username) { 
this.username = username; 

. 

public int getAge() { 
return age; 


// 应 用 类 范围 转换 ， 指 定 age 属性 的 类 型 转换 器 是 com.struts2.converter.IntegerType 
Converter 类 
@TypeConversion( 

converter="com.struts2.converter.IntegerTypeConverter™" 


< 
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public void setAge(int age) { 


this.age = age; 
} 
public Date getBirth() { 
return birth; 
} 
// 应 用 类 范围 转换 ， 指 定 birth 属性 的 类 型 转换 器 是 com. struts2.converter.DateType 
Converter 类 
@TypeConversion( 
Converter="com.struts2.converter.DateTypeConverter™" 
) 
public void setBirth (Date birth) { 
this.birth = birth; 
} 
3 


(5) 在 com.struts2.actions 包 下 新 建 用 户 注册 Action 类 一 一 RegistAction.java， 在 它 里 面 引 
了 User 动作 类 。 完 整 代码 如 下 。 
package com.struts2.actions; 


import com.opensymphony.xwork2.ActionSupport; 
import com.struts2.model .User; 


public class RegistAction extends ActionSupport { 
private User user;// 用 户 
@Override 
public String execute() throws Exception { 
return SUCCESS; 
} 
/* 下 面 是 上 面 user 属性 的 set 、get 方法 ， 这 里 省 略 */ 
} 


(6) 在 src 下 新 建 globalMessages.properties 文件 ， 即 英文 环境 的 国际 化 资源 文件 ， 用 于 类 
型 转换 失败 时 给 出 提示 信息 ， 内 容 如 下 。 


# 改 变 默认 的 类 型 转换 失败 后 的 提示 信息 


xwork.default.invalid.fieldvalue={0}invalid field value for field! 
继续 新 建 globalMessages_zh_CN.properties 文件 ， 即 中 文 环境 的 国际 化 资源 文件 ， 内 容 
如 下 。 
xwork.default .invalid.fieldvalue={0} 字 段 类 型 转换 失败 ! 
这 一 步 和 3.4.4 节 中 的 第 4、5 步 一 样 ， 这 里 可 以 直接 使 用 3.4.4 节 人 案例 中 的 国际 化 
提示 资源 文件 ， 内 容 不 变 。 


(7) 在 struts.xml 文件 中 配置 RegistAction 类 ， 并 配置 类 型 转换 失败 后 跳 转 至 “input” 的 
逻辑 视图 。 配 置 如 下 。 


<!-- 通过 常量 配置 struts2 所 使 用 的 解码 集 --> 


m= >> 
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<constant name="struts.il8n.encoding" value="gbk" /> 
<constant name="struts.devMode" value="true" /> 
<constant name="struts.custom.il8n.resources" value="globalMessages"/> 
<package name="convert" namespace="/convert" extends="struts-default"> 
<action name="regist" class="com.struts2.actions.RegistAction"> 
<result name="success">success.jsp</result> 
<result name="input">/regist.jsp</result> 
</action> 
</package> 


(8) 在 WebRoot 下 新 建 registjsp 页 面 ， 创 建 一 个 表单 及 三 个 表单 元 素 ， 内 容 如 下 。 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<%@taglib prefix="s" uri="/struts-tags" 和 > 
<form action="convert/regist.action" method="post"> 
<table align="center" width="360"> 
<tr> 
<td> 用 户 名 </td> 


<td><input name="user.username" type="text"> 


</tr> 
<tr> 
<td> 年 龄 : </td> 
<td><input name="user.age" type="text"> 
</tr> 
<tr> 
<tq> 出 生日 期 : </td> 
<td><input name="user.birth" type="text"> 
</tr> 
<tr align="center"> 
<td><input type="submit" value=" 注 册 "/><input type="reset" value=" 
重 设 "/></td> 
</tr> 
</table> 
<form> 


(9) 创建 注册 成 功 页 面 success.jsp， 输 出 注册 信息 。 使 用 <s:property ... 人 > 标签 即 可 输出 。 


3.5.4 ”运行 结果 


运行 registjsp 页 面 ， 在 页 面 的 三 个 文本 框 中 分 别 输入 : lizanhong、24、19860221， 如 


图 3-14 所 示 。 


由 于 出 生日 期 填写 的 并 不 是 “yyyy-MM-dd” 的 日 期 格式 ， 因 此 类 型 转换 失败 。 单 击 “ 注 


册 ” 按 钮 ， 跳 转 至 input 逻辑 视图 registjsp 页 面 ， 即 本 页 面 ， 提 示 类 型 转换 失败 的 信息 ， 如 
图 3-15 所 示 。 
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图 3-14 ”注册 界面 图 3-15 类 型 转换 失败 


3.5.5 ”实例 分 析 


ne 


上 面 的 实例 在 User 类 中 对 setAge0 方 法 和 setBirth0 方 法 进行 了 类 型 转换 注解 , 当 用 户 在 表 
单 中 输入 年 龄 和 出 生日 期 后 ， 系 统 将 在 对 User 类 中 的 age 属性 和 birth 属性 进行 赋值 (执行 
setXxx() 方 法 ) 时 ， 先 执行 类 型 转换 器 : IntegerTypeConverter 类 和 DateTypeConverter 类 ， 如 果 
转换 失败 ， 加 载 国际 化 资源 文件 ， 提 示 类 型 转换 失败 信息 ， 同 时 控制 台 输 出 异常 信息 。 


3.6 ”常见 问题 解答 


3.6.1 有 关 Struts 2 中 的 java.util.Date 类 型 转换 的 问题 


有 关 Struts 2 中 的 java.util.Date 类 型 转换 的 问题 ! 
网 络 课堂 : http://bbs.itzen.com/thread-10997-1-1.html 


使 用 Struts 2 开发 Web 应 用 时 ， 如 果 使 用 Date 类 型 数据 时 ，Struts 2 会 调用 Date 转换 器 来 
处 理 页 面 的 Date 字符 串 到 Date 类 型 的 转换 。 阅 读 了 Struts 2 的 Code 后 ， 发 现 javautiLDate 转 
换 器 使 用 的 日 期 格式 都 不 是 中 文 日 期 格式 ， 而 我 们 的 日 期 字符 串 格式 为 2010-11-15 17:14， 当 
找 不 到 对 应 的 日 期 格式 时 ，Struts 2 会 用 短 日 期 格式 来 处 理 (yyyy-MM-dd)， 这 时 如 果 需 要 长 日 
期 格式 的 数据 , 在 日 期 格式 转换 后 是 获取 不 到 准确 数据 的 , 遇 到 这 种 问题 时 , 着 急 该 怎么 办 呢 ? 
【解决 办 法 】: 如 果 想 要 的 值 是 2010-11-15 17:14， 而 获取 到 的 值 是 2010-11-15， 没 有 了 
时 间 ， 常 有 两 种 解决 办 法 。 第 一 种 就 是 将 日 期 类 型 改 为 字符 串 类 型 ， 在 业务 处 理 时 转换 ， 第 二 
种 是 在 日 期 的 getXxx0 方 法 中 增加 上 当前 时 间 。 


m= >> 
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3.6.2 ”怎么 自 定义 struts 2 类 型 转换 的 全 局 与 局 部 错误 信息 


yg 怎么 自 定义 struts 2 类 型 转换 的 全 局 与 局 部 错误 信息 ? 
[es 胃 ”网 络 课堂 : http://bbs.itzcn.com/thread-10998-1-1.html 

遇 到 类 型 转换 错误 的 时 候 (也 就 是 说 不 能 进行 类 型 转换 )，Struts 2 框架 会 自动 生成 一 条 错误 
信息 ， 并 且 将 该 错误 信息 放 到 addFieldError0 方 法 里 面 。 此 时 ， 可 以 通过 配置 文件 来 蔡 换 这 条 
由 Struts 2 自动 生成 的 错误 信息 。 

1. 类 型 转换 全 局 错误 信息 的 设 定 

(1) 在 strmuts.xml 文件 中 添加 以 下 代码 。 

<constant name="struts.custom.il8n.resources" value="message"></constant> 

其 中 , name 的 值 是 固定 的 , value 的 值 表示 国际 化 资源 文件 的 文件 名 为 message.properties。 

(2) 生成 message.properties 文件 ， 存 放 目 录 为 classes 的 根 目录 。message.properties 文件 
内 容 如 下 。 

xwork.default.invalid.fieldvalue={0} error 

其 中 ，“xwork.default.invalid .fieldvalue ”为 固定 的 ，“{0}” 相 当 于 一 个 占 位 符 ， 会 被 页 
面 表单 中 元 素 的 名 字 填 充 ， 是 动态 的 。xwork.default.invalid.filedvalue 的 值 表示 当前 整个 项 目 任 
何 一 个 属性 转换 失败 时 ， 会 提示 “ {0}( 即 属性 的 名 字 )error”。 

2. 类 型 转换 局 部 错误 信息 的 设 定 

在 要 进行 类 型 转换 的 类 的 同 级 目录 下 新 建 ClassName.properties 文件 ， 设 置 类 属性 转换 失 
败 提示 信息 ， 代 码 如 下 。 


invalid.fieldvalue.age=age is error 
invalid.fieldvalue.birthday=birthday is error 
invalid.fieldvalue.graduation=graduation is error 


文件 名 中 的 ClassName 要 与 进行 类 型 转换 的 类 名 称 一 样 ， 但 扩展 名 为 properties， 存 放 路 
径 要 与 进行 类 型 转换 的 类 相同 。 其 中 的 “age”、“birthday” 和 “graduation” 与 进行 类 型 转换 
的 类 的 属性 名 对 应 ， 后 面 为 类 型 转换 失败 后 的 提示 信息 。 


3.6.3 自 定义 Struts 2 中 类 型 转换 失败 提示 信息 问题 


自 定义 Struts 2 中 类 型 转换 失败 提示 信息 问题 ! 
网 络 课堂 : http://bbs.itzcn.comy/thread-10999-1-1.html 

新 建 了 ClassName-properties 文件 将 框架 自 带 的 信息 替换 掉 ， 可 是 发 现 不 支持 中 文 ， 而 页 
面 中 设置 的 支持 中 文 ! 此 事 该 如 何 解 决 ? 


必 人 mm 


< 人 web 开发 学 习 实录 . 汪 


【解决 办 法 】: 如 果 你 是 熟 手 ， 这 样 的 问题 对 你 来 说 是 最 简单 不 过 了 ，properties 文件 不 支 
持 中 文 ， 需 要 把 中 文 转换 成 相应 的 Unicode 码 ，JDK 里 面 有 转换 工具 。 


3.6.4 _ Struts 2 标签 <s:datetimepicker> 中 获取 到 的 日 期 格式 如 何 转换 


Struts 2 标签 <s:datetimepicker> 中 获取 到 的 日 期 格式 如 何 转 换 ? 
网 络 课堂 : http://bbs.itzcn.com/thread-11000-1-1.html 

我 对 Struts 2 标签 <s:datetimepicker> 不 是 很 了 解 ， 但 是 每 次 遇 到 时 间 类 型 的 我 都 用 这 个 标 
签 来 解决 ， 得 到 的 日 期 格式 是 : Sun May 04 00:00:00 CST 2010， 需 要 转换 为 “2010-05-04 
09:48:17.687” 格 式 ， 怎 么 解决 啊 ? 

【解决 办 法 】: 解决 这 类 问题 有 两 种 方法 : 第 一 种 方法 是 在 Action 类 中 加 入 DateFormat. 
getDateInstance0. format(new DateO); 获 取 当 前 时 间 即 可 ; 第 二 种 方法 是 可 以 在 页 面 中 加 入 以 下 
代码 。 

<s:head theme=” ajax” /> 

这 样 ， 就 可 以 在 页 面 中 使 用 标签 了 ， 如 下 面 代码 所 示 。 

<s:datetimepicker name="todayDate" value="2010-05-04" label="Format 

(YYYY-MM-dd) " displayFormat="yyyy-MM-dd"/> 


一 、 填 空 题 
(1) Web 开发 中 ， 很 多 情况 下 需要 使 用 自 定义 类 型 转换 器 ， 而 使 用 自 定义 类 型 转换 器 时 ， 
需要 自 定义 转换 器 类 ， 并 且 需 要 把 自 定义 的 转换 器 类 注册 到 Web 程序 中 ， 注 册 方 式 有 三 种 ， 
) 分 别 是 : 注册 局 部 类 型 转换 器 、 注 册 全 局 类 型 转换 器 和 5 
9 (2) 比如 一 个 程序 中 有 一 个 com.struts2.model.Student 类 ， 它 有 三 个 属性 ， 分 别 是 name、 
age 和 sex， 在 com.struts2.actions.StudentAction 类 中 有 如 下 属性 : 


Private Set students; 


其 中 ，Set 集合 中 的 元 素 类 型 为 com.struts2.model.Student 类 。 在 局 部 类 型 转换 注册 文件 


StudentAction-conversion properties 中 添加 代码 ， 可 以 指定 Set 集合 元 素 的 索引 属性 
名 为 Student 类 中 的 name 属性 。 

(3) Stmuts 2 提供 类 型 转换 异常 处 理 机 制 ， 提 供 名 称 为 的 拦截 器 ， 这 个 拦截 器 
被 注册 在 默认 拦截 器 栈 中 。 


(4) Stmuts 2 允许 改变 类 型 转换 失败 后 的 提示 信息 ， 只 要 在 应 用 的 国际 化 资源 文件 中 增加 
如 下 一 行 代 码 即 可 
={0} 字 段 类 型 转换 失败 ! 


m= > 


二 、 选 择 题 


(1) 局 部 类 型 转换 器 的 注册 方式 需 提供 文件 名 为 


A. ActionName-conversion.properties 
B. ClassName-conversion.properties 
C. ActionName.properties 

D. ClassName.properties 
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格式 的 文件 。 


(2) 例如 存在 一 个 com.struts2.model.Student 类 , 它 有 三 个 属性 , 分 别 是 name、age 和 sex， 
并 有 相应 的 setter、getter 方法 ， 若 com.struts2.actions.StudentAction 有 如 下 属性 。 


private List students; 


那么 如 何 指定 List 集合 元 素 为 com.struts2.model.Student 类 型 呢 ? 
A. 在 com.struts2.actions 包 下 新 建 StudentAction-conversion.properties 文件 ( 即 
StudentAction 的 局 部 类 型 转换 注册 文件 )， 内 容 如 下 。 


Element students=com.struts2.model.Student 


B. 在 com.struts2.actions 包 下 新 建 StudentAction-conversion.properties 文件 ( 即 
StudentAction 的 局 部 类 型 转换 注册 文件 )， 内 容 如 下 。 


Element Student =com.struts2.model.Student 


C. 在 com.struts2.actions 包 下 新 建 StudentAction-conversion.properties 文件 ( 即 
StudentAction 的 局 部 类 型 转换 注册 文件 )， 内 容 如 下 。 


students=com.struts2.model.Student 


D. 在 com.struts2.actions 包 下 新 建 StudentAction-conversion.properties 文件 ( 即 
StudentAction 的 局 部 类 型 转换 注册 文件 )， 内 容 如 下 。 


Student =com.struts2.model.Student 


(3) 在 使 用 TypeConversion 注解 时 ， 设 置 type 为 : type=ConversionType.CLASS， 和 转换 规 
则 将 从 一 个 名 为 文件 中 转 配 ， 该 文件 和 其 相关 的 Action 类 在 同一 个 包 中 。 


A. xwork-conversion.properties 

B. ClassName.properties 

C. ClassName-conversion.properties 
D. ActionName-conversion.properties 


三 、 上 机 练习 
上 机 练习 : 计算 长 方形 的 面积 。 


要 求 : 在 页 面 中 输入 长 方形 的 长 和 宽 ( 如 20.153)， 之 间 以 逗号 (,) 隔 开 ， 如 图 3-16 所 示 。 如 
果 输 入 的 数据 不 是 整数 类 型 ， 则 返回 input 逻辑 视图 ， 并 提示 类 型 转换 失败 信息 ， 如 图 3-17 


所 示 。 
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图 3-17 类 型 转换 失败 提示 信息 
如 果 输 入 的 长 和 宽 都 是 整数 类 型 ， 单 击 “ 确 定 ” 按 钮 ， 表 单 提交 至 RectangleAction 类 的 


execute() 方 法 中 ， 在 执行 此 方法 之 前 ， 先 对 用 户 输入 的 数据 进行 类 型 转换 ， 转 换 成 功 计算 长 方 
形 的 面积 ， 返 回 success 逻辑 视图 ， 界 面 如 图 3-18 所 示 。 


计算 苦 方 且 弄 取 
Mmm Rms 


图 3-18 计算 长 方形 面积 的 结果 界面 


国际 化 与 异常 处 理 


内 容 摘要 : 


在 Java 语言 国际 化 API 中 ， 影 响 数据 本 地 化 的 因素 主要 有 两 个 : 一 个 是 用 户 的 语言 环境 ， 
另 一 个 就 是 用 户 的 时 区 。 语言 环境 表示 某 一 特定 区 域 或 文化 的 语言 习惯 ， 包 括 时 间 数 字 和 货币 
金额 的 格式 。 时 区 是 数据 本 地 化 中 的 第 二 个 因素 ， 这 是 因为 一 些 语言 环境 分 布地 理 区 域 广泛 。 
由 于 地 球 的 自转 ,造成 世界 上 的 各 个 国家 或 地 区 在 时 间 上 有 差异 , 而且 各 个 国家 或 地 区 的 日 期 
显示 方式 也 不 一 样 。 聪 明 的 JSP 开发 人 员 早 已 解决 了 这 个 问题 ! 对 于 这 个 问题 的 解决 方法 ， 将 
是 本 章 所 介绍 的 知识 内 容 。 

学 习 目 标 : 

@ Java 国际 化 的 思路 。 
Struts 2 中 的 全 局 国际 化 资源 文件 。 
输出 国际 化 消息 。 
使 用 Action 范围 的 国际 化 。 
使 用 刘 8n 标签 实现 国际 化 。 
使 用 Struts 2 实现 国际 化 。 


Ar 2 Web 开发 学 习 实录 -# 


4.1 国际 化 基础 


互联 网 的 出 现 将 不 同 国家 、 不 同 地 区 的 人 们 联系 到 了 一 起 ， 也 为 使 用 互联 网 的 人 们 带 来 了 
各 种 信息 。 由 于 地 域 不 同 ， 不 同 民 族 使 用 的 语言 也 存在 很 大 的 差异 。 因 此 就 出 现 一 个 问题 ， 如 
何 才能 使 不 同 区 域 的 用 户 都 可 以 读 懂 同一 个 Web 页 面 为 大 家 提供 的 信息 呢 ? 例如 ， 一 个 中 国 
用 户 如 何 能 够 轻松 阅读 一 个 由 英国 用 户 提供 的 页 面 呢 ? 通过 使 用 国际 化 这 一 手段 , 可 以 实现 这 
一 目的 。 

信息 的 国际 化 ， 可 以 动态 构建 一 个 具有 各 种 不 同 语言 版 本 的 Web 应 用 程序 ， 成 为 面向 国 
际 应 用 的 Web 页 面 。 当 然 ， 这 一 功能 需要 利用 Java 语言 的 Unicode 字符 集 。 本 节 将 向 读者 介 
绍 利用 Struts 2 实现 国际 化 的 基础 知识 。 


cc 视频 教学 : 光盘 /videos/04/Internation1.avi @@ 长 度 : 7 分 钟 
光盘 /videos/04/Internation2.avi 图 长 度 : 6 分 名 
光盘 /videos/04/Internation3.avi @@ 长 度 : 6 分 名 
光盘 /videos/04/Internation4.avi 加 上 度 : 9 分 名 


4.1.1 基础 知识 一 一 国际 化 与 本 地 化 


国际 化 (Internationalization) 是 设计 和 制造 容易 适应 不 同 区域 要 求 的 产品 的 一 种 方式 。 它 要 
求 从 产品 中 抽 离 所 有 的 与 语言 、 国 家 /地 区 和 文化 相关 的 元 素 。 换 言 之 ， 应 用 程序 的 功能 和 代 
码 设计 考虑 在 不 同 地 区 运行 的 需要 , 其 代码 简化 了 不 同 本 地 版 本 的 生产 。 开 发 这 样 程 序 的 过 程 ， 
就 称 为 国际 化 。 
本 地 化 (Localization) 是 为 解决 网 站 、 软 件 向 其 他 国家 推广 时 遇 到 的 语言 障碍 问题 。 网 站 需 
要 翻 详 成 不 同 国家 的 语言 , 以 便 不 同 国家 的 人 能 够 无 障碍 地 阅读 网 站 内 容 , 这 便 是 网 站 本 地 化 ; 
? 软件 也 需要 本 地 化 ， 以 便 能 够 在 目标 国家 推广 。 本 地 化 不 仅仅 是 简单 的 文字 翻译 转换 ， 还 必须 根 
据 目标 语言 国家 的 市 场 特 点 、 文 化 习惯 、 法 律 等 情况 进行 本 地 特性 开发 、 界 面 布局 调整 等 工作 。 
下 面 将 讲解 一 下 国际 化 过 程 中 使 用 到 的 一 些 基 础 知识 。 


4.1.2 ”基础 知识 Locale 类 


Locale 类 有 Locale(String langeuage) 和 Locale(String language,String country) 两 个 常用 的 构 
造 方 法 。 其 中 langeuage 表示 语言 ， 它 的 取 值 范围 在 ISO-639 定义 的 小 写 的 、 两 个 字符 组 成 的 
语言 代码 。country 表示 国家 或 者 地 区 ， 它 的 取 值 范围 是 ISO-3166 定义 的 大 写 的 、 两 个 字符 组 
成 的 代码 。 表 4-1 和 表 4-2 列 出 了 ISO-639 语言 代码 和 ISO-3166 国家 区 域 代 码 。 


m= > 
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表 4-1 常用 的 1SO-639 语言 代码 


让 
山 


英语 


Locale 的 应 用 语法 如 以 下 代码 所 示 。 
Locale locale = new Locale("zh","CN"); 


为 了 方便 开发 人 员 的 理解 开发 ， 在 Locale 类 中 还 定义 了 许多 Locale 对 象 的 常量 ， 供 开发 
人 员 开 发 。 主 要 应 用 于 国家 和 地 区 的 Locale 对 象 如 以 下 代码 所 示 。 


Locale.CHINR // 中 国 
Locale.US // 美 国 
Locale.UK // 英 国 
Locale.CRANRDR // 加 拿 大 
Locale. FRANCE // 法 国 
Locale.ITALY // 澳 大 利 亚 
Locale.KOREA // 韩 国 
Locale.PRC // 中 华人 民 共和 国 
Locale. JAPAN // 日 本 


同样 ，Locale 对 象 还 提供 了 常用 的 语言 常量 ， 详 细 如 以 下 代码 所 示 。 


Locale.CHINESE 

Locale .ENGLISH 

Locale .JAPANESE 

Locale .FRENCH 
Locale.TRADITIONAL CHINESE 
Locale.SIMPLIFIED CHINESE 


在 Locale 类 中 ， 还 定义 了 一 个 静态 的 方法 getDfault0)， 用 于 获取 本 地 系统 默认 的 
提示 Locale 对 象 。 要 查看 Java 支持 的 所 有 语言 环境 ， 可 以 调用 Locale 类 中 的 静态 方法 
getAvailableLocales0 函 数 ， 该 函数 返回 一 个 Locale 对 象 数组 。 


ET | 
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4.1.3 ”基础 知识 资源 包 


在 编写 应 用 程序 的 时 候 , 需要 面 对 的 一 个 问题 是 如 何 处 理 与 locale 相关 的 一 些 信息 。 例 如 ， 
页 面 上 的 一 些 静 态 文本 能 够 以 用 户 习 惯 的 语言 显示 。 最 原始 的 做 法 是 将 这 些 信息 编码 到 程序 中 
(可 能 是 一 大 串 判 断 语句 )， 但 是 这 样 就 将 程序 代码 和 易 变 的 locale 信息 捆绑 在 一 起 ， 以 后 如 果 
需要 修改 locale 信息 或 者 添加 其 他 的 locale 信息 ， 就 显得 不 太 方便 。 而 资源 包 可 以 帮助 解决 这 
个 问题 ， 它 通过 将 可 变 的 locale 信息 放 入 资源 包 来 达到 两 者 分 离 的 目的 。 应 用 程序 可 以 自动 地 
通过 当前 的 locale 设置 到 相应 的 资源 包 中 取得 所 要 的 信息 .资源 包 的 概念 类 似 于 Windows 编程 
人 员 使 用 的 资源 文件 (re 文件 )。 

获取 资源 包 有 以 下 几 种 不 同 的 获取 方法 。 我 们 需要 调用 ResourceBundle 类 中 的 静态 方法 
getBundle()。 

@ ”根据 基 名 和 得 到 以 资源 包 ， 使 用 系统 缺 省 的 Locale 对 象 ， 语 法 如 下 所 示 。 


public static final ResourceBundle getBundle (String baseName) 


@ 根据 基 名 和 Locale 对 象 获取 资源 包 ， 语 法 如 下 所 示 。 
该 方法 返回 的 是 一 个 Locale 对 象 , 在 上 面 已 经 提 到 需要 使 用 getBundle0 方 法 , 只 是 参 
数 不 同 而 已 ， 故 关系 明确 。 


public static final ResourceBundle getBundle (String baseName,Locale 
locale) 


@ ”从 资源 包 中 根据 关键 字 得 到 值 。 
利用 ResourceBundle 类 的 getObject0 方 法 ， 还 可 以 从 资源 包 中 得 到 任何 需要 的 对 象 ， 
语法 如 下 所 示 。 
public final Object getObject (String key) 
利用 getBundle0 方 法 可 以 得 到 对 应 于 某 个 Locale 对 象 的 资源 包 ， 然 后 利用 
ResourceBundle 类 的 getString0 方 法 得 到 相应 语言 版 本 的 字符 串 ， 语 法 如 下 所 示 。 
? public final String getString(String key) 
如 果 在 使 用 资源 类 的 时 候 需要 扩展 资源 类 , 那么 必须 要 扩展 ResourceBundle 类 , 这 个 
时 候 需要 实现 下 面 两 个 方法 。 
”返回 资源 包 的 关键 字 枚 举 ， 语 法 如 下 所 示 。 
public abstract Enumeration getKeys () 
4 从 资源 包 中 根据 关键 字 得 到 对 象 ， 语 法 如 下 所 示 。 
protected abstract Object handleGetObject (String key) 
为 了 方便 开发 人 员 的 编写 和 使 用 ， 在 java.util 包 中 还 提供 了 ListResource Bundle 和 
PropertyResourceBundle 两 个 资源 类 ， 它 们 都 是 从 ResourceBundle 类 中 派生 出 来 的 。 
在 编程 的 时 候 如 果 想 使 用 ListResourceBundle 类 ， 只 需要 将 所 有 的 资源 放 入 一 个 对 象 数组 
即 可 ， 它 还 提供 了 查找 资源 的 功能 。 


m= > 
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如 果 全 部 的 资源 都 是 字符 串 类 型 ， 可 以 使 用 PropertyResourceBundle 类 。 该 类 对 于 不 同 的 
家 分 别提 供 不 同 的 文件 ， 它 们 的 属性 文件 名 称 都 有 一 定 的 规律 ， 都 是 资源 类 的 命名 方式 ， 它 
们 的 扩展 名 都 是 .properties， 文 件 的 内 容 都 是 以 键 值 对 的 形式 存储 的 。 

在 加 载 资源 的 时 候 可 以 使 用 ResourceBundle 类 的 getBundle() 静 态 方法 。 该 方法 执行 顺序 是 ， 
先 加 载 资源 类 ， 如 果 没 有 成 功 则 加 载 属性 资源 文件 ， 如 果 成 功 则 创建 Property ResourceBundle 
对 象 


getBundle0 静 态 方法 将 会 按照 下 列 顺序 查找 资源 包 。 

ChinaResource zh CN.class 

ChinaResource zh CN.properties 

ChianaResource zh.class 

ChinaResource zh.properties 

ChinaResource.class 

ChinaResource.properties 
司 的 语言 编写 可 以 对 应 不 同 的 资源 文件 , 对 应 不 同 的 程序 , 非常 有 利于 开发 者 开发 项 目 。 
属性 文件 中 保存 了 7 位 ASCII 码 字符 ,对 于 中 文字 符 需 要 通过 转换 为 相应 的 Unicode 码 ， 
其 格式 为 XXXX。 在 JDK 的 开发 工具 包 中 ， 可 以 通过 native2ascii 工具 将 非 ASCII 字符 转换 
为 Unicode 编码 。 


让 >Jeeeeee 


4.1.4 ”基础 知识 一 一 加 载 资源 文件 的 顺序 


在 Struts 2 框架 中 ， 可 以 设置 多 种 形式 的 资源 文件 ， 这 些 资 源 文件 具有 一 定 的 优先 级 ， 这 
个 优先 级 ， 也 就 是 Struts 2 框架 加 载 资源 文件 的 顺序 。 对 国际 化 信息 的 加 载 情况 ， 可 以 分 为 两 
类 ， 在 Action 中 和 在 JSP 文件 中 。 

1. 在 Action 中 

如 果 国际 化 信息 在 Action 类 中 ， 这 时 加 载 资源 文件 的 顺序 如 下 。 

(1) 优先 加 载 Action 范围 资源 文件 ， 即 在 Action 所 在 目录 下 ，basename 为 该 Action 类 名 
的 资源 文件 。 

(2) 如 果 在 (1) 中 找 不 到 指定 Key 值 ， 则 加 载 其 父 类 Action 的 资源 文件 。 例 如 存在 父 类 
Action， 其 类 名 为 FatherName， 则 查找 basename 为 FatherName 的 资源 文件 。 

(3) 如 果 在 (2) 中 找 不 到 指定 Key 值 ， 则 加 载 所 实现 的 接口 类 的 资源 文件 。 例 如 Action 实 
现 接 口 InterfaceName， 则 查找 basename 为 InterfaceName 的 资源 文件 。 

(4) 如 果 在 (3) 中 找 不 到 指定 Key 值 ， 且 Action 实现 接口 ModelDriven， 则 使 用 getModel0 
方法 返回 的 model 对 象 ， 重 新 执行 (1)。 

(5) 如 果 在 (4) 中 找 不 到 指定 Key 值 ， 则 查找 当前 包 下 ，basename 为 package 的 资源 文件 。 

(6) 如 果 在 (5) 中 找 不 到 指定 Key 值 ， 则 沿 着 当前 包 向 上 查找 ， 查 找 basename 为 package 
的 资源 文件 ， 直 到 最 顶层 包 。 

(7) 如 果 在 (6) 中 找 不 到 指定 Key 值 , 则 获得 struts.custom.il8n.resources 常量 所 指定 的 value 
值 ， 加 载 basename 为 该 value 值 的 资源 文件 。 
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(8) 如 果 在 上 面 的 步骤 中 仍然 找 不 到 指定 Key 值 ， 则 直接 输出 这 个 Key 的 字符 串 值 。 


@， 如 果 在 从 (1) 到 (7) 的 步骤 中 ， 找 到 指定 Key 对 应 的 值 ， 则 系统 停止 查找 ， 然 后 输出 
提示 Key 对 应 的 资源 信息 。 


2. 在 JSP 文 件 中 

如 果 国 际 化 信息 在 JSP 文件 中 通过 text 标签 或 者 表单 标签 来 定义 , 这 时 加 载 资源 文件 的 顺 
序 ， 分 为 以 下 两 种 情况 。 

1) “使 用 Struts 2 的 il8n 标签 

(1) 从 il8gn 标签 指定 的 国际 化 资源 文件 中 ， 加 载 指 定 Key 对 应 的 值 。 

(2) 如 果 在 (1) 中 找 不 到 指定 Key 值 , 则 查找 struts.custom.il8n.resources 常量 所 指定 的 value 
值 ， 加 载 basename 为 该 value 值 的 资源 文件 。 

(3) 如 果 在 上 面 的 步骤 中 仍然 找 不 到 指定 Key 值 ， 则 直接 输出 这 个 Key 的 字符 串 值 ， 如 
果 在 前 面 的 任意 一 个 步骤 中 ， 找 到 指定 Key 对 应 的 值 ， 则 系统 停止 查找 ， 然 后 输出 Key 对 应 
的 资源 信息 。 

2) ”没有 使 用 Struts 2 的 il8n 标签 

(1) 这 时 的 text 标签 和 表单 标签 ,如 果 没 有 被 包含 在 ilgn 标签 中 , 则 直接 查找 struts.custom. 
il8n.resources 常量 所 指定 的 value 值 ， 加 载 basename 为 该 value 值 的 资源 文件 ， 如 果 找 到 对 应 
Key 值 ， 则 输出 Key 对 应 的 资源 信息 。 

(2) 如 果 在 (1) 中 找 不 到 指定 Key 值 ， 则 直接 输出 这 个 Key 的 字符 串 值 。 


4.2 将 用 户 注册 国际 化 


本 节 主 要 讲解 将 用 户 注册 程序 改变 为 一 个 国际 化 的 用 户 注册 程序 。 不同 的 用 户 浏览 器 语言 
环境 不 同 ， 访 问 显示 的 页 面 语言 也 不 同 ， 接 下 来 就 如 何 实现 国际 化 注册 程序 的 步骤 给 以 讲解 。 


A9 
?视频 教学 ， 光盘/videos/04/configl.avi 加 长 度 : 6 分 钟 
3 光盘 /videos/04/config3.avi 人 @@ 长 度 : 11 分钟 


4.2.1 基础 知识 国际 化 的 配置 文件 

Stmuts 2 框架 将 国际 化 信息 定义 在 资源 文件 中 ， 在 配置 文件 中 对 资源 文件 进行 配置 ， 告 诉 
Struts 2 框架 所 需要 加 载 的 资源 文件 。 在 不 同 的 配置 文件 中 ， 对 资源 文件 的 配置 方式 不 同 。 

1. 使 用 struts.xml 文件 


在 struts.xml 文件 中 配置 国际 化 资源 文件 ， 一 般 是 通过 设置 常量 来 实现 。 例 如 ， 配 置 一 个 
basename 为 globalMessages 的 国际 化 资源 文件 ， 代 码 如 下 。 


<constant name="struts.custom.il8n.resources" value="globalMessages"/> 
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2. 使 用 struts.properties 文件 
如 果 在 struts.properties 文件 中 实现 ， 则 需要 使 用 Key-Value 的 代码 格式 ， 配 置 代码 如 下 。 


struts.custom.il8n.resources=globalMessages 


3. 使 用 web.xml 文 件 


如 果 在 web.xml 文件 中 实现 ， 则 需要 使 用 <param-name> 和 <param-value> 元 素 ， 配 置 代 码 
如 下 。 
<init-param> 
<param-name>struts.custom.il8n.resources</param-name> 


<param-value>globalMessages</param-value> 
</init-param> 


合 =” 配置 Struts 2 国际 化 资源 文件 时 ， 最 好 是 在 struts.xml 或 者 struts.properties 文件 中 
技巧 实现 。 
通过 上 述 三 种 形式 的 配置 代码 , 可 以 发 现 , 配置 Struts 2 国际 化 资源 信息 需要 两 个 值 : struts. 
custom.il8n.resources 和 global Messages。 
(1) struts.custom.il8n.resources: 在 Struts 2 框架 中 ,表示 国际 化 的 常量 ， 是 一 个 固定 不 变 
的 值 。 
(2) globalMessages: 表示 全 局 国际 化 资源 文件 的 basename 值 ， 对 应 的 全 局 国际 化 资源 文件 ， 
可 以 是 globalMessages_zh_CN.properties、globalMessages_en_US.properties 等 ， 这 些 文 件 名 都 
符合 globalMessages_language_country 的 格式 。 


4.2.2 ”基础 知识 一 一 在 文本 中 使 用 参数 
Struts 2 为 开发 者 提供 了 两 种 不 同 的 在 消息 中 设置 参数 的 方式 。 


1. 占 位 符 的 方式 

占 位 符 的 方式 就 是 Java 中 设置 消息 文本 参数 的 方式 , 相当 于 使 用 从 {0} 到 {9} 的 占 位 符 。 当 
使 用 MessageFormat 类 的 format0 方 法 格式 化 消息 字符 串 时 ， 参 数 信息 内 容 传 递 进来 ， 替 换 掉 
消息 文本 中 的 占 位 符 。 

2. OGNL 表达 式 

使 用 OGNL 表达 式 方式 ， 不 同 于 在 标签 的 属性 中 使 用 的 OGNL 表达 式 ， 在 消息 文本 中 使 
用 OGNL 表达 式 的 语法 是 : ${ms}。 

例如 ， 设 置 用 户 登 录 时 提示 用 户 登 录 后 的 欢迎 消息 ， 资 源 文件 代码 如 下 所 示 。 

ms=$ {username} ,您 好 ! 欢迎 登录 窗 内 网 个 人 空间 ! 

在 登录 成 功 首页 面 内 设置 text 标签 ， 来 输出 资源 文件 中 的 消息 内 容 ， 代 码 如 下 所 示 。 


<s:text name="ms"> 


< 
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获取 键 值 为 ms 的 消息 文本 时 ，$ 人 中 的 表达 式 ms 将 会 根据 栈 自动 进行 计算 ， 最 后 显示 到 
页 面 中 替换 消息 后 的 内 容 信 息 。 

在 消息 文本 中 使 用 数字 占 位 符 可 以 看 成 是 被 动 地 接受 值 ， 而 OGNL 表达 式 则 可 以 看 成 是 
主动 地 获取 值 。 


4.2.3 ”基础 知识 访问 国际 化 消息 


在 Java 国际 化 中 ， 使 用 MessageFormat 类 来 处 理 占 位 符 。Struts 2 作为 一 个 优秀 的 MVC 
框架 ， 为 占 位 符 提供 更 加 简单 的 操作 方式 。 

在 Struts 2 框架 中 ， 访 问 国际 化 消息 主要 有 如 下 两 种 情况 。 

@ 在 JSP 文 件 中 : 使 用 <s:text name="key"/>， 或 者 为 表单 元 素 指定 一 个 key 属性 。 

@ 在 Action 类 中 : 使 用 ActionSupport 类 的 getText0 方 法 。 

所 以 ， 要 处 理 Struts 2 中 的 占 位 符 ， 也 有 以 下 两 种 情况 。 

@ 在 JSP 文 件 中 : 在 Struts 2 框架 的 text 标签 中 ， 使 用 param 标签 引用 国际 化 资源 中 的 
占 位 符 。 一 个 param 标签 对 应 一 个 占 位 符 。 

@ ”在 Action 类 中 : 使 用 ActionSupport 类 中 的 getText0 方 法 。 根据 占 位 符 的 个 数 和 类 型 ， 
getText() 方 法 的 声明 有 多 种 方式 ， 如 表 4-3 所 示 。 

表 4-3 getText() 方 法 的 声明 方式 


说 明 
以 国际 化 资源 文件 中 的 Key 作为 参数 
以 List 集合 作为 第 二 个 参数 ， 集 合 中 的 每 个 元 素 分 别 对 
应 keyName 中 的 一 个 占 位 符 
以 字符 串 数组 作为 第 二 个 参数 ， 数 组 中 的 每 个 元 素 分 别 
对 应 keyName 中 的 一 个 占 位 符 
如 果 找 不 到 国际 化 资源 信息 , 则 返回 defaultValue 对 应 的 
内 容 
如 果 找 不 到 国际 化 资源 信息 , 则 返回 defaultValue 对 应 的 
内 容 


声明 方式 
String getText(String keyName) 


String getText(String keyName.List args) 


String getText(String keyName,String[] args) 


String getText(String keyName.String defaultValue. 
List args) 

String getText(String keyName.String defaultValue. 
String[] args) 


1. 在 JSP 页 面 中 访问 本 地 化 消息 

经 常 使 用 Struts 2 的 读者 都 知道 , 它 为 我 们 提供 了 一 个 <s:text/> 标 签 ,用 于 访问 本 地 化 消息 。 
在 JSP 页 面 中 可 以 通过 text 标签 访问 键 为 message 的 消息 内 容 。 例 如 : 

message= 登 录 成 功 

<s:text name="message"> 

在 使 用 过 程 中 ， 如 果 传 输 的 消息 内 容 有 参数 ， 可 以 通过 使 用 恢 套 的 param 标签 设置 需要 填 
充 的 参数 信息 。 例 如 : 
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<s:text name-"message"> 

<s:param value=" 段 韶 治 "/> 

</s:text> 

message={0}， 欢 迎 您 登录 我 们 的 系统 。 

在 上 述 代 码 中 ， 看 到 的 param 标签 的 顺序 和 在 消息 文本 中 的 占 位 符 顺 序 是 相同 的 ， 其 中 
param 标签 蔡 换 文本 文件 中 {0} 占 位 符 。 但 是 在 text 标签 中 最 多 只 能 眉 套 10 个 param 参数 标签 。 

2. 在 Action 中 访问 本 地 化 消息 

在 Struts 2 中 使 用 在 Action 中 访问 本 地 化 消息 , 首先 要 知道 Struts 2 中 TextProvider 接口 中 
定义 了 要 访问 本 地 化 消息 的 方法 , 同时 ActionSupport 类 也 可 以 实现 该 接口 。 所 以 在 编写 Action 
类 继承 自 ActionSupport 类 时 ， 可 以 直接 使 用 这 些 方法 。 

此 外 ，ActionSupport 提供 了 很 多 重 载 的 getText0 方 法 ， 用 来 访问 本 地 化 信息 ， 接 下 来 列举 
几 个 常用 的 getText0 方 法 。 


public String getText (String textName) 


参数 textName 是 键 的 消息 内 容 ， 如 果 没 有 找到 ， 则 返回 null。 

public String getText (String textName,String defaultName) 

参数 textName 和 上 述 一 样 ， 如 果 没 有 查找 到 ， 则 返回 defaultName 信息 。 

public String getText (String textName,List args) 

参数 textName 和 上 述 一 样 ， 而 args 表示 用 来 代 蔡 列表 消息 中 的 占 位 符 ， 第 一 个 参数 替换 
占 位 符 {0}， 依 次 类 推 。 

public String getText (String textName,String[] args) 

参数 textName 和 上 述 一 样 , 参数 args 和 上 述 功能 几乎 相似 , 不 同 的 是 该 参数 是 一 个 String 
类 型 的 数组 ， 表 示 用 来 替换 数组 中 的 消息 占 位 符 ， 第 一 个 参数 替换 占 位 符 {0}， 依 次 类 推 。 接 
下 来 用 一 个 简单 的 例子 解释 如 何 使 用 getTextO 重 载 方法 。 

在 资源 配置 文件 中 写 入 如 下 内 容 : 

message={0} 您 好 ， 欢 迎 您 来 到 我 们 窗 内 网 。 您 的 等 级 为 {1} 

在 Action 中 可 以 使 用 上 面 讲 到 的 getTextO 重 载 方法 中 的 最 后 一 种 数组 重 载 ， 代 码 如 下 
所 示 。 

String msg=getText ("message",new String[]{" 段 韶 治 ",20}); 

在 代码 中 声明 msg 接受 返回 的 消息 字符 串 , 同时 使 用 了 getTextO 的 重 载 方法 ， 第 一 个 参数 
是 键 的 消息 内 容 ， 第 二 个 参数 是 一 个 String 类 型 的 数组 参数 ， 表 示 占 位 符 。 

3. 在 表单 标签 属性 中 访问 本 地 化 消息 

使 用 表单 标签 时 ， 需 要 注意 的 是 ，label 属性 的 值 通 常 都 是 从 资源 文件 中 获取 的 。 在 label 
属性 中 ， 可 以 通过 调用 getText0 方 法 来 获取 消息 的 内 容 ， 代 码 如 下 所 示 。 


<s:textfield name="user.name" label="®{getText('username')}"> 


< 人 ——— 
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此 外 ,还 可 以 使 用 Struts 2 表单 标签 中 的 key 属性 来 设置 消息 的 内 容 key, key 可 以 使 用 label 
属性 自动 生成 的 值 ， 代 码 如 下 所 示 。 


<s:textField name="user.name"key="name"> 


4. 在 资源 文件 中 访问 本 地 化 消息 


在 资源 文件 中 ， 可 以 使 用 OGNL 表达 式 ， 还 可 以 使 用 OGNL 表达 式 在 一 个 消息 文本 中 访 
问 本 地 化 消息 。 使 用 OGNL 表达 式 ${getText(“key”)} 访 问 本 地 化 消息 ， 可 以 在 两 个 消息 文本 之 
间 相 互 访问 ， 这 为 我 们 提供 了 非常 大 的 方便 。 


email= 某 某 邮箱 
error.email.invalid=${getText ("email") } 邮 箱 格 式 错误 


4.2.4 ”实例 描述 


本 实例 我 们 通过 使 用 资源 文件 将 注册 页 面 国际 化 ， 通 过 使 用 Properties Editor 工具 将 资源 
文件 中 的 中 文 编码 转换 为 Unicode 编码 格式 以 供 程序 使 用 。 当 浏览 器 访问 该 页 面 时 ， 通 过 浏览 
器 的 语言 环境 来 调用 不 同 的 资源 文件 ， 从 而 完成 想 要 的 注册 页 面 国际 化 功能 。 下 面 是 创建 国际 
化 的 主要 步骤 。 


4.2.5 ”实例 应 用 


【 例 4-1】 用 户 注册 页 面 国际 化 。 

查看 用 户 注 册页 面 ， 将 所 需要 显示 的 文字 内 容 (例如 “用 户 名 ”) 分 离 ， 保 存 到 资源 文件 内 。 
创建 一 个 与 RegisterAction 同名 的 资源 文件 ， 这 个 资源 文件 只 能 通过 RegisterAction 来 访问 ， 该 
文件 只 需要 保存 显示 注册 页 面 的 文字 内 容 。 创 建 一 个 RegisterAction” ”zh_CN.properties 文件 ， 
代码 如 下 所 示 。 

title=\u7528\u6237\u6CE8\u518C 

username=\u7528\u6237\u540D 

password=\u5BC6\u7801 

sex=\u6027\u522B 

sex.male=\u7537\u6027 

sex.female=\u5973\u6027 

email=\u90AE\u7BB1 

pwdQuestion=\u5BC6\u7801\u95EE\u9898 

PpwdAnswer=\u5BC6\u7801\u7B54\u6848 

submit=\u6CE8\u518C 

reset=\u91CD\u7F6E 

success=\u6CE8\u518C\u6210\u529F\uFFO1 

success.info=\u795D\u8D3A\uFFOC$ {user.username} \uFFOC\u6CE8\u518C\u6210\ 

u529F\uFFO1 

failure=\u6CE8\u518C\u5931\u8D25 

failure.info=\u6CE8\u518C\u5931\u8D25, \u56E0\u4E3A\uFF1AS$ {exception} .<br/>\ 

u8BF7<a href\="{0}">retry</a> 
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在 上 述 代码 中 , 通过 使 用 Properties Editor 将 需要 显示 的 文字 转换 为 Unicode 编码 格式 ， 并 
保存 在 该 资源 文件 中 。 在 success.info 和 failure.info 的 消息 文本 中 使 用 了 OGNL 表达 式 ， 
success.info 获取 User 对 象 的 username 属性 , failure.info 则 是 发 生 异 常 时 输出 栈 中 的 异常 对 象 。 

访问 RegisterAction.java 的 Action 类 ， 代 码 如 下 所 示 。 

public class RegisterAction extends Actionsupport{ 

public string execute() 
{ 
return SUCCESS; 


} 
} 


上 述 代 码 中 ,编写 了 execute0 默 认 方 法 ， 当 客户 端 发 送 请 求 到 该 页 面 时 调用 该 方法 ， 返 
到 注册 页 面 。 

下 面 是 使 用 Struts 2 提供 的 访问 国际 化 消息 的 方式 ， 显 示 页 面 信息 内 容 ， 编 写 注册 页 面 ， 
通过 Struts 2 中 的 标签 进行 显示 ， 详 细 代码 如 下 所 示 。 


<s:form> 


回 


<s:textfield name="user.username" key="username"></s:textfield> 
<s:password name="user.password" key="password"></s:password> 
<s:radio name="user.sex" value="true" 
list="#{true:getText ('sex.male'),false:getText ('sex.female’')}" 
key="sex"></s:radio> 
<s:textfield name="user.email" key="email"></s:textfield> 
<s:textfield name="user.pwdQuestion" key="pwdQuestion"></s:textfield> 
<s:textfield name="user.pwdAnswer" key="pwdAnswer"></s:textfield> 
</s:form> 


上 述 代 码 中 ， 通 过 Struts 2 提供 的 丰富 的 组 件 标签 ，( 后 面 将 进行 详细 的 讲解 ) 设 署 标签 的 
key 属性 ， 显 示 资 源 文件 的 文字 信息 。 


4.2.6 运行 结果 


启动 Tomcate 服务 器 ， 输 入 地 址 http:Wlocalhost:8080/ch4_2/registaction， 访 问 国际 化 后 的 
注册 页 面 ， 运 行 结果 如 图 4-1 所 示 。 
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图 4-1 国际 化 注册 页 面 
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4.2.7 ”实例 分 析 


Eee 


通过 上 面 的 实例 ， 可 以 学 到 如 何在 消息 文本 中 使 用 OGNL 表达 式 . 通过 获取 相应 的 属性 
信息 ， 在 页 面 上 使 用 Struts 2 中 的 标签 ， 获 取 资 源 文件 中 的 属性 值 和 内 容 ， 完 成 注册 页 面 国 
际 化 。 


4.3 消息 提示 国际 化 


制作 一 个 Web 程序 时 ， 如 果 发 生 了 错误 系统 都 会 为 用 户 提供 错误 信息 。 如 果 错 误 出 现在 
一 个 英文 环境 下 的 浏览 器 中 ， 对 于 不 懂得 英语 的 用 户 来 说 可 能 是 件 头 疼 的 事 。 但 如 果 将 错误 信 
息 编写 在 程序 中 ， 则 是 个 十 分 合理 的 解决 办 法 。 这 样 可 以 方便 用 户 使 用 和 阅读 错误 信息 ， 从 而 
找到 出 错 原因 。 本 节 的 消息 提示 国际 化 可 以 帮助 用 户 来 实现 这 一 功能 。 


. 
是 视频 教学 : 光盘 /videos/04/config2.avi 人 @@ 长 度 : 6 分 钟 


4.3.1 实例 描述 


用 户 注册 时 判断 该 用 户 名 是 否 存 在 ， 如 果 该 用 户 重 复 登 录 会 使 系统 抛 出 异常 ， 则 使 用 
Action 获取 捕获 的 异常 ， 然 后 从 定义 的 消息 资源 文件 中 获取 提示 的 错误 信息 ， 并 使 用 标签 将 消 
息 显 示 在 页 面 上 。 


4.3.2 ”实例 应 用 


【 例 4-2】 用 户 注 册 时 判断 该 用 户 名 是 否 存在 。 

首先 在 src 工程 目录 下 创建 RegisterActin zh_CN.properties 文件 ， 该 文件 用 来 显示 用 户 名 
存在 的 信息 提示 ， 详 细 代码 如 下 所 示 。 

error.username.exist=\u7528\u6237\u540D\u4EE5\u5B58\u5728\uFFO01 

接 下 来 定义 一 个 异常 处 理 类 UsernameExistException.java， 该 类 继承 自 Exception 类 ， 详 细 
代码 如 下 所 示 。 


public class UsernameExistException extends Exception{ 


} 
该 异常 处 理 类 的 主要 作用 就 是 用 来 表示 用 户 已 经 存在 这 种 异常 。 
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下 面 创建 RegisterAction 类 ， 用 来 处 理 业 务 逻 辑 的 Action 类 ， 该 类 中 包含 了 一 个 execute0 
方法 ， 用 来 判断 用 户 是 否 存在 业务 处 理 。 当 捕获 到 创建 的 UsernameExistException 异常 时 ， 系 
统 调用 addFieldError0 方 法 ， 详 细 代 码 如 下 所 示 。 


public class RegisterAction extends ActionSupport{ 


private String username; 
public String getUsername() { 
return username; 
} 
public void setUsername (String username) { 
this.username = username; 
rE 
Qoverride 
Public String execute () throws Exception { 
tryt{ 
if(username.equals ("admin")) 
. 
throw new UsernameExistException(); 
} 
}catch (UsernameExistException e) 
{ 
addFieldError ("username", getText ("error.username.exist")); 
return INPUT; 
} 
return SUCCESS; 


} 

在 上 述 代 码 中 , 获取 用 户 表 单 提交 的 用 户 信息 , 使 用 try 来 捕获 异常 。 如 果 用 户 名 为 admin， 
则 抛 出 异常 ， 代 码 运 行 到 catch 时 调用 addFieldError0 方 法 。 

最 后 设置 修改 显示 提示 信息 页 面 ， 当 用 户 名 存在 的 时 候 ， 转 交 到 信息 提示 页 面 ， 在 该 页 面 
编写 如 下 代码 。 

<body> 


<s:fielderror/> 
</body> 


使 用 Struts 2 提供 的 fielderror 异常 标签 来 显示 提示 信息 内 容 。 
4.3.3 ”运行 结果 


完成 上 述 代码 后 启动 Tomcat， 运 行 http://localhost:8080/ch4_3/， 获 得 的 结果 如 图 4-2 和 
图 4-3 所 示 。 
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图 4-2 注册 页 面 图 4-3 信息 提示 页 面 


4.3.4 实例 分 析 


a 


上 述 例子 中 , 使 用 Struts 2 中 的 <s:fielderror/> 和 异常 处 理 机 制 捕获 错误 消息 , 提示 用 户 “ 该 
用 户 名 已 经 存在 ”。 当 获取 到 异常 之 后 , 使 用 addFieldError("username", getText("error.username. 
exist")); 的 方法 将 信息 获取 返回 到 前 台 ， 并 通过 Struts 2 显示 到 页 面 上 。 


4.4 手动 改变 注册 页 面 国际 化 


没有 学 习 使 用 国际 化 之 前 ， 如 果 完 成 一 个 中 文 和 英文 版 的 Web 系统 ， 需 要 开发 两 个 同样 
的 系统 ， 然 后 将 中 文 版 的 系统 汉字 全 部 翻译 成 英语 ， 从 而 增加 了 工作 的 难度 。 如 果 学 习 了 国际 
化 相对 来 说 就 简单 多 了 ， 只 需要 将 资源 文件 中 的 中 文字 符 串 翻 详 成 英语 ， 保 存 到 对 应 的 英文 
locale 的 资源 文件 中 即 可 。 本 节 将 向 读者 介绍 一 个 手动 改变 注册 页 面 国际 化 的 典型 应 用 ， 通 过 
本 案例 的 学 习 可 以 使 读者 掌握 locale 的 使 用 方法 。 


A 
视频 教学 ， 光盘 /videos/04/locale.avi O 攻 度 : 8 分 名 


4.4.1 基础 知识 用 户 locale 流程 


国际 化 Web 程序 一 般 都 有 多 个 语言 版 本 ， 用 户 可 以 通过 语言 版 本 选择 首页 。 当 用 户 访问 
时 ,首先 给 出 这 个 首页 ， 当 用 户 选择 某 种 语言 之 后 ,可 以 使 用 相应 的 语言 类 型 更 新 首页 。 此外， 
还 可 以 由 程序 根据 浏览 器 发 送 的 请 求 报头 中 的 语言 信息 ， 来 自动 选择 一 种 语言 版 本 。 

通常 情况 下 会 使 用 第 二 种 方法 来 实现 。 下 面 讲解 一 下 Stmuts 2 如 何 设 定 访问 用 户 的 语言 环 
境 locale。 在 加 载 资源 文件 时 ，Struts 2 会 根据 ActionContext 的 getLocale0 方 法 的 返回 值 加 载 对 
应 的 资源 文件 。 如 果 要 改变 当前 的 locale， 只 需要 重新 调用 getLocale0 方 法 并 保存 到 
ActionContext 中 即 可 。 下 面 是 设 定 Struts 2 访问 locale 时 的 步骤 。 
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(1) 判断 locale 属性 是 否 有 值 ， 然 后 将 值 转换 为 Locale 对 象 保 存 到 ActionContext 内 。 

(2) 当 locale 属性 值 为 空 或 者 没有 设置 的 时 候 ， 则 获取 浏览 器 请 求 的 报头 信息 内 容 ， 然 后 
创建 Locale 对 象 并 保存 到 ActionContext 内 。 

(3) 通过 拦截 器 获取 request_locale 请 求 参数 的 值 ， 以 该 值 创建 一 个 Locale 对 象 ， 将 这 个 
对 象 作 为 session 的 WW_TRANS II8N_LOCALE 属性 ,保存 到 session 对 象 中 ， 再 把 这 个 对 象 
保存 到 ActionContext 内 。 


4.4.2 ”实例 描述 


为 了 让 用 户 更 方便 地 使 用 中 英文 的 切换 ， 一般 不 用 浏览 器 语言 环境 来 变化 ,而 是 直接 使 用 
两 个 超 链 接 “ 中 文 ” 和 “English”， 以 方便 用 户 随时 查看 不 同 版 本 的 Web 注册 程序 。 当 用 户 
单 击 “ 中 文 ” 链 接 的 时 候 ， 将 在 用 户 的 Web 页 面 上 显示 中 文 的 信息 内 容 ; 当 用 户 单 击 English 
链接 的 时 候 ， 将 在 用 户 页 面 上 显示 英文 版 的 Web 注册 系统 。 

实现 该 功能 思路 : 当 用 户 点 击 某 个 链接 时 发 送 request_ locale 请 求 参 数 。 参 数 的 内 容 是 对 
应 语言 的 Locale 对 象 的 字符 串 值 。 


4.4.3 ”实例 应 用 


【 例 4-3】 实现 用 户 注 册页 面 中 英文 版 。 

(1) 创建 一 个 Web 工程 ， 在 com.itzcn.action 包 下 创建 RegisterAction_en.properties 和 
RegisterAction_ zh_CN.properties 语言 国际 化 资源 文件 , 用 来 定义 用 户 界面 显示 中 文 版 和 英文 版 
的 信息 内 容 的 文件 。 

@@ ”RegisterAction_en.properties 资源 文件 内 容 如 下 。 

# 标 题 

title=User Register 

# 用 户 名 

username=UserName 

# 用 户 密码 
password=PassWord 

# 性 别 

Sex=Sex 

# 男 性 

sex.male=Male 

# 女 性 

Sex.female=Female 

# 邮 箱 

email=Email 

# 密 码 问题 
pwdQuestion=Password Question 
# 密 码 答 案 
pwdAnswer=Password Answer 


# 提 交 
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submit=Register 
# 重 置 


reset=Reset 


success=Register success 
success.info=${user.username}, congratulation, register success! 


failure=Register failure 

failure.info=register failure,reason:${exception} .<br/>Please<a 
href="{0}">retry</a> 

error.username .exist=Username is already exist 


# 超 链接 文本 
chinese=Chinese 
english=English 


# 提 示 信 息 


selectlanguage=please select language 
RegisterAction zh_CN.properties 资源 文件 内 容 如 下 。( 转 换 为 Unicode 码 后 的 内 容 ): 


title=\u7528\u6237\u6CE8\u518C 
username=\u7528\u6237\u540D 
password=\u5BC6\u7801 
sex=\u6027\u522B 
sex.male=\u7537\u6027 

sex. female=\u5973\u6027 
email=\u90AE\u7BB1 
pwdQuestion=\u5BC6\u7801\u95EE\u9898 
pwdAnswer=\u5BC6\u7801\u7B54\u6848 
submit=\u6CE8\u518C 
reset=\u91CD\u7F6E 


success=\u6CE8\u518C\u6210\u529F\uFFO01 
success.info=\u795D\u8D3A\uFFOC$ {user.username} \uFFOC\u6CE8\u518C\u6210 
\u529F\!\uFFO1 


failure=\u6CE8\u518C\u5931\u8D25 
failure.info=\u6CE8\u518C\u5931\u8D25, \u56E0\u4E3A\uFF1AS$ {exception}. 
<br/>\u8BF7<a href\="{0}">retry</a> 
error.username.exist=\u7528\u6237\u5DF2\u7ECF\L5B58\u5728\uFFO01 


chinese=\u4E2D\u6587 
english=\u82F1\u6587 


selectlanguage=\u8BE7\u9009\u62E9\u8BED\u8RA00 
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(2) 创建 处 理 提交 的 Action 类 ， 当 用 户 单 击 中 英文 切换 超 链接 时 ， 转 向 指定 的 Register 
Action.java 类 中 ， 在 这 里 读者 一 定 要 注意 的 是 : 资源 文件 和 Action 类 的 名 称 前 段 部 分 要 相同 ， 
详细 代码 如 下 所 示 。 
public class RegisterRction extends RctionSupport{ 
public string execute() 
return SUCCESS; 
到 

} 


在 该 类 中 ，RegisterAction 继承 于 ActionSupport， 创 建 execute0 的 方法 ， 当 用 户 请 求 该 类 
执行 完毕 时 ， 转 向 用 户 的 注册 页 面 。 
(3) 接 下 来 编辑 注册 页 面 的 信息 内 容 ， 在 该 页 面 内 主要 用 来 显示 用 户 界面 的 标题 信息 内 
容 ， 该 页 面 的 内 容 信息 从 资源 文件 内 读 取 ， 通 过 标签 绑 定 到 页 面 内 ， 详 细 代码 如 下 所 示 。 
<!-- 顶 部 --> 
<div id="header"> 
<div class="h lt"><a href="http://www.itzcn.com"><img 
src="images/logo.gif"/></a></div> 
<div class="h rt"> 
<s:set name="current locale" 
value="#session['WW TRANS I18N LOCALE']==null?locale:#session['WW TRANS 
I18N_LOCALE']"/> 
上 述 代 码 主 要 获取 locale。 在 页 面 第 一 次 访问 时 ，session 对 象 中 的 WW_TRANS I18N_ 
LOCALE 属性 为 null， 因 此 表达 式 locale 也 就 调用 了 Action 类 的 getLocale0 方 法 ， 然 后 获取 页 
面 中 的 locale 对 象 并 保存 到 current_locale 变量 内 。 当 用 户 选择 语言 超 链 接 时 ，session 对 象 中 就 
会 存在 一 个 WW_TRANS_II8N_LOCALE 属性 。 下 述 代码 则 是 设置 中 英 切换 的 超 链 接 内 容 。 
<s:url id="chinese url" value="regist.action"> 
<s:param name="request locale" 
value="@java.util.Locale@CHINA"></s:param> 
</s:url> 
<s:url id="english url" value="regist.action"> 
<s:param name="request locale" 
value="@java.util.Locale@ENGLISH"></s:param> 
</s:url> 


上 述 代码 主要 用 来 设置 中 英文 切换 的 超 链 接 。 在 这 里 使 用 到 了 Struts 2 中 的 URL 标签 。 该 
标签 内 部 有 个 param 标签 ， 它 用 来 对 请 求 路 径 附 加 请 求 参 数 信 息 。OGNL 表达 式 是 允许 访问 类 
的 静态 成 员 的 。 因 此 在 设置 request_locale 请 求 参 数 时 ， 可 以 直接 使 用 Locale 类 的 静态 常量 。 

$ 这 里 不 能 使 用 Locale 类 的 CHNESE 常量 ， 该 常量 是 表示 的 中 文 语言 的 Locale 对 
注意 | 。 象 ， 而 在 简体 中 文系 统 中 ，Struts 2 初始 构造 的 是 表示 中 国 的 Locale 对 象 . 为 了 能 
在 后 面 进行 Locale 对 象 的 比较 ， 我 们 使 用 Locale.CHINA 常量 。 


以 下 代码 则 是 用 来 输出 不 同 环境 下 的 中 英文 超 链接 代码 。 


<—— 
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<s:if test="#current locale.equals(ejava-util.LocaleeCHINR) "> 
<s:a href="%{#chinese url}"><strong> 


<s:text name="chinese"></s:text> 


</strong></s:a><s:a href="%{#english url}"><s:text 
name="english"></s:text> </s:a> 


</s:if> 


<s:else> 


<s:a href="%{#chinese url}"><s:text name="chinese"></s:text> </s:a> 
<s:a href="%{#english url}"><strong> 
<s:text name="english"></s:text> 
</strong></s:a> 
</s:else> 


</div> 


<!-- 顶 部 --> 

上 述 代 码 的 主要 作用 是 : 输出 中 文 和 英文 的 超 链 接 ， 使 用 Struts 2 中 的 让 和 else 标签 进行 
判断 ， 从 而 为 当前 的 Locale 对 象 对 应 的 超 链接 添加 样式 。 以 下 代码 则 是 用 来 绑 定 注册 页 面 提示 
信息 、 内 容 的 ， 详 细 代码 如 下 所 示 。 


<div class="content"> 


<p> 


<p> 


<p> 


<p> 


<p> 


<p> 


<label for="email"><s:text name="username"></s:text>: </label> 
<INPUT class="input" type="text" id=username name="username"> 
<span id="checkusername">&nbsp;</span> </p> 


<label for="email"> <s:text name="password"></s:text>: </label> 
<INPUT class="input" type=password id="password" name="userpass"> 
<span id="checkpassword">&nbsp;</span> </p> 


<label for="email"> <s:text name="email"></s:text>: </label> 
<INPUT class="input" maxLength=32 name="userpass2"> 
<span id="checkpassword2">gnbsp;</span> </p> 


<label for="email"><s:text name="pwdQuestion"></s:text>: </label> 
<INPUT id=email maxLength=32 class="input" name=email> 
<span id="checkemail">&gnbsp;</span> </p> 


<label for="email"> <s:text name="pwdAnswer"></s:text>: </label> 
<INPUT id=email maxLength=32 class="input" name=email> 
<span id="checkemail">&gnbsp;</span> </p> 


<INPUT type="submit" name="mysubmit" value="<s:text name="submit"/>"> 
<INPUT type="submit" name="mysubmit" value="<s:text name="reset"/>"> 


</p> 


</div> 


上 述 代 码 用 来 设置 注册 页 面 的 注册 提示 信息 的 绑 定 , 在 这 里 同样 使 用 Struts 2 中 的 <s:text/> 
标签 ， 将 信息 内 容 从 不 同 的 语言 资源 文件 中 读 取出 来 ， 显 示 在 该 标签 内 。 在 前 几 章节 中 已 经 讲 
解 到 注册 页 面 文本 内 容 的 国际 化 ， 这 里 就 不 再 过 多 讲解 。 


Ed >> 


第 4 章 “国际 化 与 异常 处 理 


运行 Tomcate 服务 器 ， 启 动 项 目 ， 在 浏览 器 地 址 栏 中 输入 : http:Wlocalhost:8080/ch4 
4/regist.action， 显 示 注 册页 面 运行 结果 如 图 4-4 和 图 4-5 所 示 。 


rar 


免 关注 册 密 内 网 nnnen zaeent ca) 国宝 
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图 4-4 中 文 下 的 注册 页 面 图 4-5 英文 下 的 注册 页 面 


在 上 面 运行 结果 中 ， 单 击 图 4-4 中 的 “英文 ”链接 则 显示 图 4-5 中 的 英文 效果 注册 页 面 ， 
单 击 Chinese 时 则 再 次 显示 图 4-4 中 的 运行 结果 图 。 


4.4.5 ”实例 分 析 


an 


在 上 述 实 例 中 ,通过 使 用 Locale 对 象 来 设置 语言 环境 ， 从 而 改变 注册 页 面 的 显示 语言 。 通 
过 使 用 Struts 2 中 的 标签 来 显示 英文 和 中 文 的 切换 超 链 接 ， 同 时 使 用 判断 标签 来 改变 选中 的 超 
链接 样式 。 

同时 通过 上 面 的 实例 ， 我 们 知道 通过 struts.locale 属性 来 设置 Web 应 用 程序 的 默认 locale。 
在 程序 运行 过 程 中 ， 如 果 需 要 修改 当前 的 locale， 只 需要 提交 名 为 request locale 的 请 求 参数 即 
可 。 如 果 拦 截 器 从 request_ locale 请 求 参数 创建 了 Locale 对 象 ， 那 么 就 会 在 session 中 保存 一 个 
名 为 WW_TRANS I18N_LOCALE 的 属性 。 


4.5 ”Struts 2 异常 处 理 


任何 成 熟 的 MVC 框架 都 应 该 提供 成 熟 的 异常 处 理 机 制 ，Struts 2 也 不 例外 。Struts 2 框架 
提供 了 一 种 声明 式 的 异常 处 理 方式 ， 通 过 配置 拦截 器 来 实现 异常 处 理 机 制 。 


. 
上 视频 教学 : 光盘 /videos/04/Exception.avi 人 @@ 长 度 : 7 分 名 
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4.5.1 基础 知识 一 一 传统 异常 处 理 方式 
在 传统 的 Java 程序 中 ， 所 有 异常 对 象 的 根 类 是 Throwable， 从 Throwable 类 直接 派生 的 异 
常 类 有 Exception 和 Error。 


Error 表示 Java 程序 中 出 现 一 个 非常 严重 的 异常 错误 , 这 个 错误 可 能 是 程序 所 不 能 
提示 够 恢复 的 , 例如 ThreadDeath 等 . 所 以 说 , 传统 的 Java 异常 , 主要 是 指 对 Exception 
的 处 理 。 


在 Exception 异常 处 理 的 过 程 中 ， 一 般 通过 try{}catch0{}finally 语句 ， 或 者 使 用 throws 
Exception 来 捕获 异常 。 在 应 用 程序 中 ，Exception 异常 和 从 它 派生 出 来 的 所 有 异常 ， 都 可 以 通 
过 使 用 catch 语句 捕捉 到 。 

例如 , 在 本 地 硬盘 下 盘 下 创建 一 个 文件 夹 exception。 在 exception 文件 夹 中 , 创建 三 个 Java 
类 ， 在 其 中 的 两 个 类 中 定义 异常 信息 ， 然 后 在 第 三 个 Java 类 中 引入 这 两 个 异常 类 ， 从 而 实现 
对 传统 异常 的 处 理 。 以 下 是 其 操作 的 主要 步骤 。 

(1) 创建 两 个 类 文件 : MyException.java 和 ThrowableException.java， 让 这 两 个 类 分 别 继承 
不 同 的 异常 类 。MyException 类 继承 了 Exception 类 ， 该 类 的 主要 内 容 如 下 所 示 。 

Public class MyException extends Exception{ // 继 承 Exception 类 

public MyException(){ 
super (); 
} 
public MyException(String message){ 
super (message); 
} 
} 


在 MyException 类 中 ， 实 现 两 个 构造 方法 。 如 果 在 调用 该 类 时 还 有 其 他 参数 ， 可 以 在 该 类 
中 定义 包含 不 同 参数 形式 的 多 个 构造 方法 。 
ThrowableException 类 继承 Throwable 类 ， 该 类 的 主要 内 容 如 下 述 代码 所 示 。 
public class ThrowableException extends Throwable{ // 继 承 Thorwable 类 
public ThrowableException(){ 
super (); 
} 
public ThrowableException(String message){ 
super (message); 


1 


上 述 两 个 文件 分 别 继承 Exception 类 和 Throwable 类 ， 由 于 这 两 个 类 都 是 在 Java 
提示 的 基础 包 javalang 包 中 ， 所 以 不 需要 使 用 import 语句 引入 。 


(2) 在 exception 文件 夹 下 ， 创 建 UseException.java 文件 ， 在 该 文件 中 引用 前 面 所 定义 的 
异常 类 。UseException 类 的 主要 内 容 如 下 所 示 。 


Et 全)>> 


public class UseException { 
public static void myException()throws MyException{ 
throw new MyException ("MyException 抛 出 一 个 异常 ! "); 
} 
public static void throwableException () throws ThrowableException{ 
throw new ThrowableException ("ThrowableException 抛 出 一 个 异常 ! ") ; 
} 
public static void main(String[] args){ 
trYT{ 
UseException.myException(); 
}catch (MyException mye){ 
System.out .println ("Exception:" +mye.getMessage()); 
mye.printstackTrace (); 
} 
tryt{ 
UseException.throwableException(); 
}catch (ThrowableException the){ 
System.out.println ("Exception:" +the.getMessage()); 
the.printstackTrace (); 


} 


在 UseException 类 中 ， 首 先 定义 myException0 方 法 和 throwableException() 方 法 ， 在 这 两 
个 方法 中 ， 分 别 调用 MyException 类 和 ThrowableException 类 中 包含 一 个 参数 的 方法 。 然 后 在 
主 方法 main0 中 ， 使 用 tryf}catch0 人 语句 捕获 相应 的 异常 ， 并 输出 显示 。 

(3) 编译 上 述 三 个 Java 类 ， 然 后 运行 UseException 类 ， 将 输出 通过 try{}catch0 人 语句 捕 
获 到 的 异常 信息 和 异常 路 径 。 输 出 结果 如 图 4-6 所 示 。 


图 4-6 使 用 传统 异常 类 


4.5.2 ”基础 知识 Struts 2 异常 处 理 机 制 


在 Stmts 2 框架 中 ， 可 以 采用 声明 式 异 常 处 理 方式 。 在 这 种 方式 下 ， 只 需要 在 struts.xml 
文件 中 进行 配置 ，Struts 2 便 能 够 处 理 异 然后 响应 相应 的 视图 ， 在 Action 中 无 须 编写 任何 
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异常 处 理 代码 。 
》 如果 Action 在 处 理 请 求 的 过 程 中 出 现 异 常 , 一 个 名 为 exception 的 拦截 器 将 拦截 该 
提示 异常 ， 并 进行 处 理 。 
为 了 实现 异常 处 理 ，Struts 2 框架 在 struts-default.xml 文件 中 对 exception 拦截 器 进行 了 配 
置 ， 代 码 如 下 。 
<interceptors> 


<interceptor name="exception™" 
class="com.opensymphony .xwork2.interceptor.ExceptionMappingInterceptor"/> 


ne eptors 

在 实现 Struts 2 异常 处 理 时 , 只 需要 在 struts.xml 文件 中 对 异常 类 型 和 处 理 异 常 后 返回 的 结 
果 进 行 配置 就 可 以 了 。 

如 果 Action 在 处 理 请 示 的 过 程 中 出 现 异常 ，exception 拦截 器 将 拦截 该 异常 ， 并 根据 异常 
返回 到 相应 的 视图 页 面 。Struts 2 框架 进行 异常 处 理 的 流程 如 图 4-7 所 示 。 


发 送 请 求 Kani 图] 
控制 器 大 
视图 ? 


图 4-7 Struts 2 处 理 异常 流程 


4.5.3 ”基础 知识 一 一 配置 异常 处 理 


在 本 小 节 中 ， 将 介绍 配置 异常 映射 的 <exception-mapping> 元 素 、 对 异常 配置 的 分 类 以 及 在 

JSP 文件 中 输出 异常 的 方式 。 
; 1， 配置 异常 映射 

在 struts.xml 文件 中 ， 使 用 <exception-mapping> 元 素 ， 对 exception 拦截 器 进行 异常 映射 配 
置 ， 该 元 素 有 以 下 两 个 必 选 属性 。 

@@ exception: 用 来 指定 出 现 异常 的 类 型 。 

@ result 用 来 指定 出 现 异常 时 ，Struts 2 返回 给 用 户 的 视图 名 称 。 

2. 异常 配置 分 类 

根据 异常 映射 作用 的 范围 ， 可 以 将 异常 映射 配置 分 为 以 下 两 类 。 

1) 全 局 异常 映射 

全 局 异常 映射 的 作用 范围 是 package 中 的 所 有 Action。 这 种 映射 使 用 <global-exception- 
mappings> 元 素 进行 配置 ， 并 在 该 元 素 中 翌 套 <exception-mapping> 作 为 子 元 素 。 
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2) ”局 部 异常 映射 
局 部 异常 映射 的 作用 范围 是 配置 元 素 所 在 的 Action。 这 种 映射 是 在 Action 内 部 ， 使 用 


<exception-mapping> 元 素 进 行 配置 。 


图 》 这 两 种 异常 映射 的 优先 级 不 同 ， 当 两 种 映射 有 冲突 时 ， 局 部 异常 映射 将 覆盖 全 局 
注意 | 。 异常 映射。 


例如 ， 在 struts.xml 文件 中 配置 全 局 异常 映射 和 局 部 异常 映射 ， 代 码 如 下 所 示 。 


<package name="default" extends="struts-default"> 
<global-results> 
<result name="sqlException">/sqlException.jsp</result> 
</global-results> 
<global-exception-mappings> 
<exception-mapping result="sqlException™" 
exception="java.sql.SQLException"/> // 配 置 全 局 异常 映射 
</global-exception-mappings> 
<action name="register" class="action.Register"> 
<exception-mapping result="myException™" 


exception="java.lang.Exception"/> // 配 置 局 部 异常 映射 
<result name="myException">/myException.jsp</result> 
</action> 
</package> 


上 述 代 码 中 ， 配 置 全 局 异常 映射 sqlException， 异 常 类 型 为 java.sql.SQLException。 在 全 局 
结果 中 ， 为 全 局 映射 配置 返回 结果 为 sqlException.jsp。 
在 <action> 元 素 中 ， 配 置 局 部 异常 映射 myExceptionp， 异 常 类 型 为 java.lang.Exception， 使 


用 <result> 元 素 为 myException 异常 进行 配置 ， 返 回 结果 为 myException.jsp。 


3. 输出 异常 信息 


可 以 使 用 Struts 2 中 的 property 标签 输出 异常 信息 。 
如 果 输 出 异常 对 象 本 身 ， 代 码 如 下 。 


<s:property value="exception.message"/> 
如 果 输 出 异常 堆栈 信息 ， 代 码 如 下 。 


<s:property value="exceptionStack"/> 


4.5.4 ”实例 描述 


之 前 我 在 刚 接触 开发 的 时 候 经 常会 遇 到 这 样 的 一 系列 问题 ， 比 如 说 编写 一 个 注册 程序 ， 当 
户 在 数据 年 龄 中 输入 的 是 不 合法 的 字符 或 者 是 负数 时 ， 程 序 将 会 崩溃 并 抛 出 异常 。 学 习 了 


Struts 2 之 后 ， 我 才 发 现 这 样 的 问题 并 不 难 解决 。 通 过 使 用 Struts 2 异常 处 理 机 制 就 可 以 实现 理 
想 中 的 效果 ， 下 面 以 一 个 简单 的 用 户 注册 抛 出 异常 并 且 作出 相应 的 处 理 为 实例 来 进行 讲解 。 


< 
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4.5.5 “实例 应 用 


【 例 4-4】 用 户 注册 异常 处 理 。 
本 节 以 用 户 注册 为 例 ， 使 用 Struts 2 的 异常 处 理 机 制 ， 捕 获 相应 的 异常 。 首 先 创建 Web 应 
ch4_exception， 配 置 Struts 2 开发 环境 。 
(1) 创建 JSP 文件 registerjsp， 在 该 文件 中 有 注册 表单 ， 另 外 定义 输出 异常 信息 的 语句 。 
register.jsp 文件 的 主要 内 容 如 下 所 示 。 
<%@ page language="java" pageEncoding="GB2312"%> 
<%@ taglib prefix="s" uri="/struts-tags" %> 
<strong> 用 户 注册 </strong><br> 
<s:property value="exception.message"/> 


<s:form action="register"> 
<s:textfield name="userName" label=" 姓 名 "/> 
<s:textfield name="userAge"” label=" 年 龄 "/> 
<s:submit value=" 提 交 "/> 

</s:form> 


在 property 标签 中 ， 定 义 value 属性 值 为 exception.message， 表 示 输 出 异常 信息 。 
(2) 在 src/action 文件 夹 下 , 新建 Action 类 文件 RegisterException.java, 在 该 文件 中 封装 注 
册 信 息 userName 和 userAge 属性 。RegisterException.java 类 的 内 容 如 下 所 示 。 


package action; 
import java.sql.SQLException; 
import com.opensymphony.xwork2.ActionSupport; 
public class RegisterException extends ActionSupport{ 
private String userName; 
private int userAge; 
// 省 略 属性 的 setxxx () 和 getxxx() 方 法 
public String execute () throws Exception { 
if(userName == null || "".equals (userName)){ 
throw new Exception ("异常 姓名 不 能 为 空 ! ") ; 
) } 
if(userAge < 0 || userAge > 150){ 
throw new SQLException ("SQL 异常 : 添加 数据 异常 ,年 龄 不 符合 要 求 ! ") ; 
上 
if(userName.length() > 10 ){ 
throw new SQLException ("SQL 异常 : 添加 数据 异常 ,姓名 长 度 不 符合 要 求 ! ") ; 
} return SUCCESS; 


} 


在 上 述 Action 类 的 execute0 方 法 中 , 接收 用 户 输入 的 姓名 和 年 龄 属性 值 , 然后 对 这 些 值 进 
行 判 断 ， 根 据 不 同 的 情况 ， 定 义 不 同 的 提示 信息 。 

(3) 在 struts.xml 文件 中 ， 配 置 异常 映射 和 控制 器 Action。 其 中 ， 配 置 两 个 异常 映射 ， 一 
个 是 全 局 映射 ， 另 一 个 是 局 部 映射 。<package> 元 素 中 的 内 容 如 下 所 示 。 
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<global-results> 
<result name="showException">/register.jsp</result> 
</global-results> 
<global-exception-mappings> 
<exception-mapping result="showException" 
exception="java.lang.Exception"/> 
</global-exception-mappings> 
<action name="register" class="action.RegisterException"> 
<result name="showException">/register.jsp</result> 
<result name="success">/register.jsp</result> 
<exception-mapping result="showException™" 
exception="java.sql.SQLException"/> 
</action> 


在 <global-exception-mappings> 全 局 映射 中 ， 配 置 java.lang.Exception 异常 。 在 注册 Action 
配置 中 ， 配 置 局 部 异常 映射 java.sql.SQLException。 


4.5.6 ”运行 结果 


运行 Tomcate 服务 器 启动 项 目 , 在 地 址 栏 中 输入 行 http://localhost:8080/ch4_5/regist.action, 
将 用 户 姓名 的 内 容 输入 为 室 ， 单 击 【 提 交 】 按 钮 后 ， 显 示 所 定义 的 异常 信息 ， 如 图 4-8 所 示 。 
如 果 用 户 姓 名 不 为 空 ， 将 用 户 年 龄 输入 不 符合 要 求 的 内 容 ， 显 示 异 常 信息 如 图 4-9 所 示 。 


免费 注册 坑内 网 namamsomeeent ca) 


图 4-8 姓名 不 能 为 空 图 4-9 年 龄 不 符合 要 求 


4.5.7 ”实例 分 析 


pe 


上 述 实例 中 ， 在 JSP 页 面 定义 value 属性 值 为 exception.message， 用 来 显示 错误 的 消息 ， 
RegisterException 类 获取 提交 数据 时 会 判断 数据 是 否 合法 ， 如 果 不 合 法 则 抛 出 异常 ， 然 后 在 
struts.xml 中 配置 全 局 和 局 部 的 异常 映射 。 
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4.6 常见 问题 解答 


4.6.1 Struts 2 国际 化 中 文 乱 码 解决 问题 


Struts 2 国际 化 中 文 乱码 如 何 解决 ? 
网 络 课堂 : http://bbs.itzcn.com/thread-11001-1-1.html 

开发 工具 : MyEclipse， 所 有 的 文件 编码 都 设置 为 utf-8。 所 有 过 程 正常 开发 结束 后 ， 将 
messagesource.propertis 本 地 化 ， 代 码 如 下 。 


native2ascii messagesource.propertis messagesource zh CN.propertis 

启动 运行 ， 发 现 页 面 上 从 资源 文件 中 读 取 的 内 容 为 乱码 。 解 决 方法 : 本 地 化 时 指定 编码 方 
式 即 可 ， 代 码 如 下 。 

native2ascii -encoding UTF-8 messagesource.propertis 

messagesource zh CN.propertis 

Java 本 身 就 支持 多 国语 言 编码 ， 不 需要 写 任何 程序 便 可 以 很 简单 地 实现 ， 秘 诀 就 是 以 下 
两 点 。 

@ ”所 有 HTML/JSP 页 面 全 部 采用 UTF-8 编码 。 

@ 客户 端 浏览 器 完全 支持 UTF-8 编码 。 

步骤 : 

(1) 把 所 有 的 HTML/JSP 的 ContentType 都 设 为 UTF-8。 

(2) 对 于 JSP 程 序 中 的 非 ASCI 码 提示 信息 ,都 不 应 该 写 在 程序 里 面 ,应 该 放 在 application. 
properties 里 面 统一 管理 。 

(3) 对 HTML 用 native2ascii 工具 统一 做 一 次 处 理 ， 把 HTML 中 的 非 ASCII 码 都 转换 为 
Unicode 编码 。 

(4) 针对 不 同 的 语言 ， 写 不 同 的 application.properties， 比 如 说 简体 中 文 是 application_ 
zh_CN.properties， 繁 体 中 文 是 application_zh_TW.properties， 然 后 对 这 些 配置 信息 文件 同样 用 
native2ascii 工具 处 理 一 次 ， 把 非 ASCII 码 统一 转 为 Unicode 编码 。 

(5) 在 Servlet 类 中 ， 使 用 request.getCharacterEncoding() 获 得 客户 端的 操作 系统 默认 编码 ， 
然后 使 用 set0 方 法 将 该 编码 放 入 HTTPSession 的 Locale 中 。 

OK! 现在 不 同 的 客户 访问 ， 就 会 显示 不 同 的 语言 版 本 了 。 此 时 自己 浏览 器 的 字符 集 就 是 
UTF-8。 现 在 网 站 和 Google 一 样 了 ， 细 心 的 读者 可 以 发 现 自己 的 浏览 器 访问 Google 的 时 候 也 
是 UTF-8。 

切记 : 所 有 的 HTML/JSP 都 要 设 为 UTF-8 编码 ， 所 有 文件 中 的 非 ASCII 码 字 符 都 要 用 
native2ascii 工具 进行 转换 。 
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4.6.2 ”使 用 Struts 2 国际 化 标签 的 错误 问题 


项 辆 使 用 Struts 2 国际 化 标签 的 错误 问题 ? 
[a 芭 ”网 络 课堂 : http://bbs.itzcn.com/thread-15762-1-1.html 


在 编写 程序 时 ， 使 用 到 了 <s:url> 标 签 。 可 是 出 现 了 错误 ， 编写 的 代码 如 下 所 示 。 


<%@ page language="java" pageEncoding="GB2312"$%> 

<html><head> 

<meta http-equiv="X-UA-Compatible" content="IE=7"> 

<meta http-equiv="content-type" content="text/html;charset=gb2312"> 
<title> 国 际 化 </title> 

<body> 

<s:url id="chinese url" value="regist.action"> 


<s:param name="request locale" 
value="@java.util.Locale@CHINA"></s:param> 
</s:url> 
<s:url id="english url" value="regist.action"> 
<s:param name="request locale" 
value="@java.util.Locale@ENGLISH"></s:param> 
</s:url> 
</body> 
</html> 


请 问 是 哪里 出 了 问题 ， 我 找 了 好 长 时 间 都 没有 找到 原因 ? 

【解决 办 法 】: 据 我 观察 之 所 以 出 现 错误 的 原因 在 于 没有 引入 该 标签 的 标签 库 。 你 将 以 下 
代码 引入 运行 页 面 应 该 可 以 避免 出 现 错 误 ! 

<%@ taglib prefix="s" uri="/struts-tags" $%> 


上 述 代码 是 将 struts-tags 标签 库 引 入 到 页 面 中 ， 因 为 用 到 的 <s:url> 标 签 就 在 该 标签 库 内 。 


4.7 习 题 


一 、 填 空 题 

(1) 国际 化 的 软件 应 该 具有 可 扩展 性 、 全 球 化 和 的 特征 。 

(2) 通过 软件 和 软件 本 地 化 ， 提 供 满足 特定 国际 市 场 的 文化 、 语 言 和 技术 要 求 
的 产品 ， 使 得 产品 的 销售 市 场 扩大 。 

(3) 在 Java 国际 化 中 ， 使 用 MessageFormat 类 处 理 ，Struts 2 作为 一 个 优秀 的 


MVC 框架 ， 对 占 位 符 提供 更 加 简单 的 操作 方式 。 

(4) 在 Struts 2 应 用 程序 中 创建 资源 文件 时 ， 如 果 文 件 名 为 package language_country. 
properties， 其 中 package 为 固定 的 字符 囊 ， 和 country 表示 相应 的 语言 和 国家 ， 那 
么 该 文件 就 是 包 范围 资源 文件 。 
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(5) 在 Strts2 框架 中 ， 允 许 为 每 个 Action 创建 对 应 的 资源 文件 ， 如 果 该 资源 文件 名 称 为 
RegisterAction language country.properties， 那 么 为 指定 Action 的 名 称 。 
(6) 如 果 不 需要 客户 端 修改 浏览 器 的 语言 首选 项 ， 那 么 在 应 用 程序 中 ， 可 以 通过 
的 方式 ， 设 置 用 户 的 区 域 语言 。 
二 、 选 择 题 
(1) 使 用 Java 进行 国际 化 时 ， 所 使 用 的 类 都 是 由 java.util 包 提供 的 . 该 包 中 不 相关 的 类 有 


ss i 
. ResourceBundle 
. ListResourceBundle 
. PropertyResourceBundle 

() 直列 不 属于 Struts 2 框架 的 资源 文件 的 是 
A. 全 局 资源 文件 
B. Action 范围 资源 文件 
C. 临时 资源 文件 
D. 永久 型 资源 文件 
在 Struts2 中， 下 面 是 不 正确 的 访问 位 资源 文件 中 的 本 地 化 消息 内 容 。 
A. 在 JSP 页 面 中 访问 本 地 化 消息 
B. 在 Action 中 访问 本 地 化 消息 
C.， 在 表单 标签 属性 中 访问 本 地 化 消息 
D. 在 HTML 中 访问 国际 化 消息 

三 、 上 机 练习 

上 机 练习 : 中 英文 版 登录 界面 。 

要 求 : 用 户 登录 界面 实现 一 个 简单 的 中 英文 切换 ， 当 用 户 单 击 【 英 文 〗】 按 钮 时 则 该 页 面 显 
示 的 文字 为 英文 版 的 登录 页 面 ， 当 用 户 单 击 Chinese 按钮 时 则 显示 中 文 版 的 登录 界面 。 运 行 结 
果 如 图 4-10 和 图 4-11 所 示 。 
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图 4-10 中文 版 登录 界面 图 4-11 英文 版 登录 界面 
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内 容 摘 要 : 
拦截 器 (Interceptor) 是 Struts 2 的 一 个 重要 特性 。Struts 2 框架 的 大 多 数 核心 功能 都 是 通过 拦 
截 器 来 实现 的 ， 像 避免 表单 重复 提交 、 类 型 转换 、 对 象 组 装 、 验 证 、 文 件 上 传 等 ， 都 是 在 拦截 
器 的 帮助 下 实现 的 。 拦 截 器 之 所 以 称 为 “拦截 器 ”， 是 因为 它 可 以 在 Action 执行 之 前 调用 。 
Struts 2 允许 以 一 种 可 插 拔 的 方式 来 管理 Action 需要 完成 的 通用 操作 ， 并 将 这 些 通用 操作 
定义 为 拦截 器 方法 ， 然 后 在 struts.xml 文件 中 配置 Action 时 引入 该 Action。 
这 一 章 将 介绍 如 何 配置 拦截 器 (Intercepton)， 以 及 它 在 Struts 2 中 是 如 何 对 Action 和 JSP 进 
行 拦 截 的 。 当 然 我 们 也 可 以 自 定义 拦截 器 ， 对 其 进行 拦截 。 
学 习 目标 : 
@ 掌握 拦截 器 的 配置 。 
掌握 自 定义 拦截 器 的 步骤 及 配置 。 
熟练 运用 方法 过 滤 拦 截 器 。 
了 解 Struts 2 的 内 置 拦截 器 。 
掌握 拦截 器 注解 操作 。 
熟练 掌握 权限 控制 拦截 器 。 
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5.1 配置 和 使 用 拦截 器 
拦截 器 (Intercepton) 是 Struts 2 的 一 个 强 有 力 的 工具 ， 有 许多 功能 都 是 构建 于 它 之 上 ， 如 国 
际 化 、 转 换 器 和 校 验 等 。 下 面 将 讲解 在 Struts 2 中 如 何 配 置 和 使 用 拦截 器 。 


9 
ws 视频 教学 : 光盘 /videos/05/interceptor.avi 外 长 度 : 9 分 钟 
光盘 /videos/05/Timer.avi 图 长 度 : 4 分 名 


5.1.1 基础 知识 一 一 配置 和 使 用 拦截 器 


拦截 器 , 在 AOP(Aspect Oriented Programming) 中 用 于 在 某 个 方法 或 字段 被 访问 之 前 , 进行 
拦截 。 然 后 在 之 前 或 之 后 加 入 某 些 操作 。 拦 截 器 是 AOP 的 一 种 实现 策略 。 

拦截 器 允许 在 Action 的 执行 前 后 插入 代码 执行 。 Struts 2 中 的 拦截 器 是 一 个 强 有 力 的 工具 ， 
它 可 以 为 Action 动态 添加 输入 验证 (验证 用 户 的 输入 是 否 正确 )、 对 象 组 装 (将 用 户 输入 的 数据 转 
换 为 对 象 的 属性 )、 权 限 控制 (确保 访问 者 是 登录 用 户 )， 日 志 记录 (记录 action 的 执行 情况 ) 等 功 
能 ， 而 不 需要 修改 Action 。 

Stmuts 2 的 拦截 器 实现 相对 简单 。 当 请 求 到 达 Struts 2 的 ServletDispatcher 时 ，Struts 2 会 查 
找 相对 应 的 配置 信息 ， 并 实例 化 拦截 器 对 象 。 串 成 一 个 列表 (lisD， 最 后 一 个 一 个 地 调用 列表 中 
的 拦截 器 ， 如 图 5-1 所 示 。 


Struts 2 拦截 器 1 拦截 器 2 Action Result 
! 


二 一 
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interceptor 


宣 


interceptor execute 
= 一 本 一 一 一 一 全 


execute 


5-1 ”拦截 器 调用 序列 图 
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1. 配置 拦截 器 

引入 拦截 器 机 制 ， 可 以 实现 对 Action 通用 操作 的 可 插 拔 式 管理 ， 这 种 可 插 拔 管理 是 基于 
struts.xml 配置 文件 实现 的 。 

1) ”配置 拦截 器 

在 struts.xml 文件 中 定义 拦截 器 只 需 为 拦截 器 类 指定 一 个 拦截 器 名 称 即 可 。 使 用 
<interceptor.…/> 元 素来 定义 拦截 器 ， 其 最 简单 的 格式 如 下 。 

<!-- 通过 指定 拦截 器 名 和 拦截 器 实现 类 来 定义 拦截 器 --> 

<interceptor name=" 拦 截 器 名 ” class=" 拦 截 器 实现 类 "/> 

大 部 分 时 候 ， 只 需要 通过 上 面 的 格式 就 可 完成 拦截 器 的 配置 。 如 果 还 需要 在 配置 拦截 器 时 
传 入 拦截 器 参数 ， 则 需要 在 <interceptor... 人 > 元 素 中 使 用 <param.../> 子 元 素 。 下 面 是 在 配置 拦截 
器 时 ， 同 时 传 入 拦截 器 参数 的 配置 形式 。 

<!-- 通过 指定 拦截 器 名 和 拦截 器 实现 类 来 定义 拦截 器 --> 

<interceptor name=" 拦 截 器 名 "” class=" 拦 截 器 实现 类 "> 

<!-- 下 面 元 素 可 以 出 现 0 次 ， 也 可 以 出 现 无 数 次 ， 其 中 name 属性 指定 需要 设置 的 参数 名 ， 
中 间 指 定 的 就 是 该 参数 的 值 --> 
<param name=" 参 数 名 "> 参数 值 </param> 

</interceptor> 

2) ”配置 拦截 器 栈 

除了 上 面 的 配置 拦截 器 外 ， 还 可 以 把 多 个 拦截 器 连 在 一 起 组 成 拦截 器 栈 ， 例 如 : 如 果 需 要 
在 Action 执行 前 同时 做 登录 检查 、 安 全 检查 和 记录 日 志 , 则 可 以 把 这 三 个 动作 对 应 的 拦截 器 组 
成 一 个 拦截 器 栈 。 定 义 拦截 器 栈 使 用 <interceptor-stack.…/> 元 素 , 拦截 器 栈 是 由 多 个 拦截 器 组 成 
的 ， 因 此 需要 在 <interceptor-stack.../> 元 素 中 使 用 <interceptor-ref.../> 元 素来 定义 多 个 拦截 器 引 
用 ， 即 该 拦截 器 栈 由 多 个 <interceptor-ref... 人 > 元 素 指定 的 拦截 器 组 成 。 


$》 从 程序 结构 上 来 看 ， 拦 截 器 栈 是 由 多 个 拦截 器 组 成 的 ， 即 一 个 拦截 器 栈 包 含 了 多 
旨 示 | 。 个 拦截 器 ; 但 从 程序 功能 上 来 看 ， 拦 截 器 栈 和 拦截 器 是 统一 的 ， 它 们 包含 的 方法 
都 会 在 Action 的 execute 方法 执行 之 前 自动 执行 。 
下 面 我 们 就 来 配置 一 下 拦截 器 栈 ， 代 码 如 下 所 示 。 


<interceptor-stack name=" 拦 截 器 栈 "> 
<interceptor-ref name=" 拦 截 器 一 "/> 
<interceptor-ref name=" 拦 截 器 二 "/> 


<!-- 还 可 配置 更 多 的 拦截 器 --> 


</interceptor-stack> 


上 面 的 配置 片段 示例 , 配置 了 一 个 名 为 “拦截 器 栈 ” 的 拦截 器 栈 , 这 个 拦截 器 由 下 面 的 “ 拦 
截 器 一 ”和 “拦截 器 二 ”组 成 ， 当 然 还 可 以 包含 更 多 的 拦截 器 ， 只 需 在 <interceptor-stack.…./> 
元 素 下 配置 更 多 的 <interceptor-ref..…./> 子 元 素 即 可 。 
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一 旦 将 上 面 的 “拦截 器 一 ”和 “拦截 器 二 ”配置 成 了 名 为 “拦截 器 栈 名 ”的 拦截 
a 示 | 器 栈 后 ， 就 可 以 完全 像 使 用 普通 拦截 器 一 样 使 用 拦截 器 栈 ， 因 为 拦截 器 和 拦截 器 
栈 的 功能 是 完全 相同 的 。 
由 于 拦截 器 栈 与 拦截 器 的 功能 几乎 完全 相同 ， 因 此 可 能 出 现 的 情况 是 : 拦截 器 栈 里 再 次 包 
含 拦截 栈 。 因 此 ， 可 能 出 现 如 下 的 配置 片段 如 下 。 
<interceptor-stack name=" 拦 截 器 栈 一 "> 
<interceptor-ref name=" 拦 截 器 一 "/> 


<interceptor-ref name=" 拦 截 器 二 "/> 


<!-- 还 可 配置 更 多 的 拦截 器 --> 


</interceptor-stack> 

<interceptor-stack name=" 拦 截 器 栈 二 "> 
<interceptor-ref name=" 拦 截 器 三 "/> 
<interceptor-ref name=" 拦 截 器 栈 一 "/> 
<!-- 还 可 配置 更 多 的 拦截 器 --> 


</interceptor-stack> 
在 上 面 的 配置 片段 中 ， 第 二 个 拦截 器 包含 了 第 一 个 拦截 器 栈 (包含 两 个 拦截 器 )， 其 实质 就 
是 拦截 器 栈 二 由 三 个 拦截 器 组 成 : 拦截 器 三 、 拦 截 器 一 和 拦截 器 二 。 
读者 可 能 会 问 : 为 什么 不 直接 在 拦截 器 栈 二 中 直接 配置 三 个 拦截 器 的 引用 ， 而 是 通过 引用 
另 一 个 拦截 器 栈 呢 ? 答案 是 为 了 软件 复 用 。 因 为 系统 中 已 经 存在 了 一 个 名 为 “拦截 器 栈 一 ”的 
拦截 器 栈 ， 这 个 拦截 器 栈 由 两 个 拦截 器 组 成 ， 当 需要 再 次 使 用 这 两 个 拦截 器 时 ， 直 接 调 用 该 拦 
截 器 栈 即 可 , 无 须 分 别 调用 两 个 拦截 器 。 而 且 , 这 两 个 拦截 器 组 成 的 拦截 器 栈 也 可 以 单独 使 用 。 
在 使 用 拦截 器 时 指定 参数 值 , 应 通过 <interceptor-ref .. 人 > 元素 增加 <param.../> 子 元 素 为 拦截 
器 指定 参数 值 。 
下 面 是 在 配置 拦截 器 栈 时 为 拦截 器 动态 指定 参数 值 的 语法 。 
<interceptor-stack name=" 拦 截 器 栈 一 "> 
<interceptor-ref name=" 拦 截 器 一 "> 
<!-- 下 面 为 拦截 器 分 别 定义 了 两 个 参数 值 --> 
<param name=" 参 数 一 "> 参 数值 一 </param> 


<param name=" 参 数 二 "> 参数 值 二 </param> 
<!-- 还 可 指定 更 多 的 参数 值 --> 


</interceptor-ref> 
<interceptor-ref name=" 拦 截 器 二 "/> 


<!-- 还 可 配置 更 多 的 拦截 器 --> 
</interceptor-stack> 
@ > 有 两 个 时 机 为 拦截 器 指定 参数 值 ， 一 个 时 机 是 当 定义 拦截 器 (通过 <interceptor…/> 
注意 元 素来 定义 拦截 器 ) 时 指定 拦截 器 的 参数 值 ; 另 一 个 时 机 是 当 使 用 拦截 器 (通过 
<interceptor-ref.…/> 元 素 使 用 拦截 器 ) 时 指定 拦截 器 的 参数 值 。 前 者 指定 的 是 拦截 器 
参数 的 默认 值 。 
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如 果 在 两 个 时 机 为 同一 个 参数 指定 了 不 同 的 参数 值 , 则 使 用 拦截 器 时 指定 的 参数 将 会 覆盖 
默认 的 参数 值 。 

2. 使 用 拦截 器 

- 旦 定义 了 拦截 器 和 拦截 器 栈 后 , 就 可 以 使 用 拦截 器 或 拦截 器 栈 来 拦截 Action 了 , 拦截 器 

(包含 拦截 器 栈 ) 的 拦截 行为 会 在 Action 的 execute0 方 法 执行 之 前 被 执行 。 

1) 为 Action 配置 拦截 器 

通过 <interceptor-ref .. 人 > 元 素 可 以 在 Action 内 使 用 拦截 器 ， 在 Action 中 使 用 拦截 器 的 配置 
语法 与 配置 拦截 器 栈 时 引用 特定 拦截 器 的 语法 完全 一 样 。 

下 面 是 在 Action 中 定义 拦截 器 的 配置 示例 。 


<include file ="struts-default.xml" /> 
<package name="intercep" namespace="/intercep" extends="struts-default"> 
<interceptors> 
<1== 定义 第 一 个 拦截 器 > 
<interceptor name="myFirstIinterceptor™" 
class="com.myfirst.interceptor.MyFirstInterceptor"/> 
<1= 定义 第 三 个 拦截 器 一 > 
<interceptor name="mySecondInterceptor" 
class="com.mysecond.interceptor.MySecondIinterceptor"> 
<!-- 指定 该 拦截 器 的 默认 参数 值 --> 
<param name="name"> 第 二 个 拦截 器 </param> 
</interceptor> 
</interceptors> 
<!-- 配置 自 定义 的 Action， 实 现 类 为 com.myinterceptor.LoginAction --> 
<action name="login" class="com.myinterceptor.LoginAction"> 
<!-- 配置 该 Action 的 两 个 局 部 结果 --> 
<result name="error">/error.jsp</result> 
<result name="success">/success.jsp</result> 
<!-- 拦截 器 一 般配 置 在 result 元 素 之 后 --> 
<interceptor-ref name="defaultstack"/> 
<!-- 使 用 第 一 个 拦截 器 --> 
<interceptor-ref name="myFirstInterceptor"/> 
<!--- 使 用 第 三 个 拦截 器 =--> 
<interceptor-ref name="mySecondInterceptor"> 
<!-- 为 该 action 动态 指定 拦截 器 参数 --> 
<param name="name"> 动 态 参数 </param> 
</interceptor-ref> 
</action> 


</package> 
如 果 在 Action 中 配置 多 个 拦截 器 ， 则 会 按照 引用 拦截 器 的 顺序 执行 。 
2) “为 Action 配置 拦截 器 栈 
如 果 一 个 Action 需要 多 个 拦截 器 , 引用 它们 是 一 件 繁琐 的 事 。 在 此 可 以 将 多 个 拦截 器 组 合 


< 
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在 一 起 ， 组 成 一 个 拦截 器 栈 ， 然 后 在 Action 中 直接 引用 拦截 器 栈 。 


<package name="intercep" namespace="/intercep" extends="struts-default"> 
<interceptors> 
<!-- 定义 第 一 个 拦截 器 --> 
<interceptor name="myFirstInterceptor" 
class="com.myfirst.interceptor.MyFirstIinterceptor"/> 
<!-- 定义 第 二 个 拦截 器 --> 
<interceptor name="mySecondInterceptor" 
class="com.mysecond.interceptor.MySecondInterceptor"> 
<!-- 指定 该 拦截 器 的 默认 参数 值 --> 
<param name="name"> 第 二 个 拦截 器 </param> 
</interceptor> 
<!-- 定义 一 个 拦截 器 栈 --> 
<interceptor-stack name="myInterceptorSstack"> 
<interceptor-ref name="myFirstInterceptor"/> 
<interceptor-ref name="mySecondInterceptor"/> 
</interceptor-stack> 
</interceptors> 
<!-- 配置 自 定义 的 Action， 实 现 类 为 com.myinterceptor.LoginAction --> 
<action name="login" class="com.myinterceptor.LoginAction"> 
<!-- 配置 该 Action 的 两 个 局 部 结果 --> 
<result name="error">/error.jsp</result> 
<result name="success">/success.jsp</result> 
<!-- 拦截 器 一 般配 置 在 result 元 素 之 后 --> 
<interceptor-ref name="defaultStack"/> 
<!-- 为 Action 配置 拦截 器 栈 --> 
<interceptor-ref name="myInterceptorstack"/> 
</action> 


</package> 
如 果 多 个 Action 都 需要 引用 相同 的 拦截 器 ， 可 以 使 用 default-interceptor-ref 元 素来 定义 一 
个 默认 的 拦截 器 或 拦截 器 栈 引 用 ， 这 样 就 不 需要 为 每 个 Action 指定 引用 信息 了 。 
例如 下 面 的 代码 定义 了 默认 的 拦截 器 栈 引 用 。 


<default-interceptor-ref name="myInterceptorstack"/> 


@ 》 ”如果 在 一 个 Action 中 定义 了 其 他 的 拦截 器 引用 ,那么 这 个 Action 将 不 再 使 用 默认 
注意 」 的 拦截 器 引用 。 如 果 Action 想 要 在 默认 拦截 器 引用 的 基础 上 添加 新 的 拦截 器 ， 那 
么 只 能 在 Action 中 重新 配置 默认 拦截 器 引用 中 的 拦截 器 。 
Stmts 2 提供 了 丰富 多 彩 的 、 功 能 齐全 的 拦截 器 ， 读 者 可 以 到 Struts 2-all-x.jar 或 
struts 2-core-2.1.8.jar 包 中 的 struts-default.xml 中 查看 关于 默认 的 拦截 器 与 拦截 器 链 的 配置 ， 这 
里 就 不 再 多 说 了 。 


st >> 
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5.1.2 ”实例 描述 


当 程 序 非常 大 时 ,启动 服务 器 并 将 该 程序 布置 到 服务 器 上 需要 花费 很 长 的 时 间 ， 甚 至 达到 
几 小 时 。 而 到 底 用 了 多 长 时 间 成 为 程序 员 心 中 的 困惑 ， 那 么 下 面 就 来 做 一 个 可 以 计算 出 程序 的 
耗 时 功能 吧 ! 


5.1.3 ”实例 应 用 


【 例 5-1】 测试 程序 的 耗 时 。 
(1) 创建 Action(TimerInterceptorAction.java)， 内 容 如 下 。 


package com.struts2.actions; 
import com.opensymphony.xwork2.ActionSupport; 
public class TimerInterceptorAction extends RARctionSupport { 
@override 
public String execute(){ 
try { 
// 模拟 耗 时 的 操作 
Thread.sleep( 500 ); 
} catch (Exception e) { 
e.printstackTrace () 7 
return SUCCESS; 


} 
(2) 在 src 目录 下 的 struts-config 文件 夹 中 新 建 timer.xml， 对 Action 进行 配置 ,代码 如 下 。 


<?xml] version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<include file ="struts-default.xml" /> 
<package name ="InterceptorDemo" extends ="struts-default" > 
<action name ="Timer" class 
="com.struts2.actions.TimerInterceptorAction" > 
<interceptor-ref name ="timer" /> 
<result>/Timer.jsp </result> 
</action > 
</package > 
</struts> 


(3) 把 timerxml 文件 引入 到 struts.xml 中 。 


< 


图 5-2 使 用 Struts 2 框架 拦截 器 timer 后 台 服 务 器 的 输出 结果 


5.1.5 “实例 分 析 


Ce 


上 述 实例 中 ， 在 struts-default xml 中 已 经 配置 了 好 多 的 拦截 器 。 如 果 读 者 想 要 使 用 ， 只 需 

要 在 应 用 程序 struts.xml 文件 中 通过 “<include file="struts-default.xml"/>” 将 struts-default.xml 

文件 包含 进来 ， 并 继承 其 中 的 struts-default 包 (package)， 最 后 在 定义 Action 时 ， 使 用 

“<interceptor-ref name="xx"/>” 引 用 拦截 器 或 拦截 器 栈 (interceptor stack) 即 可 。 一 旦 继承 了 

struts-default 包 ， 所 有 Acton 都 会 调用 拦截 器 栈 一 一 defaultStack。 当 然 ， 在 Action 配置 中 加 入 
“<interceptor-ref name="xx"/>” 可 以 覆盖 defaultStack。 


5.2 自 定 义 拦截 器 


提 到 “ 自 定义 ”这 个 词 ， 我 想 读者 一 定 会 惊喜 Struts 2 的 出 现 ， 它 就 像 是 坐 公 交 车 不 如 坐 
自家 的 小 轿车 一 样 简单 、 快 捷 、 方 便 。 


ca 视频 教学 : 光盘 /videos/05/MyInterceptoravi 国度 : 10 分 钟 
5.2.1 基础 知识 一 一 自 定义 拦截 器 
Struts 2 框架 提供 了 许多 内 置 的 拦截 器 ， 这 些 内 置 的 拦截 器 实现 了 Struts 2 的 大 部 分 功能 ， 


因此 ， 大 部 分 Web 应 用 的 通用 功能 ， 都 可 以 通过 直接 使 用 这 些 拦截 器 来 完成 。 还 有 一 些 系统 
逻辑 相关 的 通用 功能 ， 则 可 以 通过 自 定义 拦截 器 来 实现 。 


>> 
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1. 实现 自 定义 拦截 器 类 

如 果 用 户 要 开发 自己 的 拦截 器 类 ， 应 该 实现 com.opensymphony.xwork2.interceptor. 
Interceptor 接口 ， 该 接口 的 类 定义 代码 如 下 。 

import java.io.Serializable; 


import com.opensymphony .xwork2.ActionInvocation; 
public interface Interceptor extends Serializable { 
// 销 毁 该 拦截 器 之 前 的 回调 方法 
void destroy(); 
// 初 始 化 该 拦截 器 的 回调 方法 
void init() 7 
// 拦 截 器 实现 拦截 的 逻辑 方法 


String intercept (ActionInvocation invocation) throws Exception; 

} 

通过 上 面 的 接口 可 以 看 出 ， 该 接口 里 包含 了 三 个 方法 。 

@ init0: 拦截 器 被 初始 化 之 后 ， 在 该 拦截 器 执行 拦截 之 前 ， 系 统 将 回调 该 方法 。 对 于 每 

个 拦截 器 而 言 ， 该 init0 方 法 只 执行 一 次 。 因 此 , 该 方法 的 方法 体 主要 用 于 打开 一 些 一 
次 性 资源 ， 例 如 数据 库 资源 等 。 

@ destroy0: 该 方法 与 init() 方 法 对 应 。 在 拦截 实例 被 销毁 之 前 ， 系 统 将 回调 该 拦截 器 的 

destroy() 方 法 ， 该 方法 用 于 销毁 在 init( 方 法 里 打开 的 资源 。 

@ intercept(ActionInvocation invocation): 该 方法 是 用 户 需 要 实现 的 拦截 动作 。 就 像 

Action 的 execute0 方 法 一 样 ，intercept0 方 法 会 返回 一 个 字符 串 作 为 逻辑 视图 。 如果 该 
方法 直接 返回 了 一 个 字符 串 ， 系统 将 会 跳 转 到 该 逻辑 视图 对 应 的 实际 视图 资源 ， 不 会 
调用 被 拦截 的 Action。 该 方法 的 ActionInvocation 参数 包含 了 被 拦截 的 Action 的 引用 ， 
可 以 通过 调用 该 参数 的 invoke0 方 法 ， 将 控制 权 转 给 下 一 个 拦截 器 ， 或 者 转 给 Action 
的 execute( 方 法 。 

除 此 之 外 ，Struts 2 还 提供 了 一 个 AbstractInterceptor 类 ， 该 类 提供 了 一 个 init0 和 destroyO 
方法 的 空 实现 ， 如 果实 现 的 拦截 器 不 需要 申请 资源 ， 则 可 以 无 须 实现 这 两 个 方法 。 可 见 ， 采 用 
继承 AbstractInterceptor 类 来 实现 自 定义 拦截 器 会 更 加 简单 。 

@ 5 当 实 现 intercept(ActionInvocation invocation) 方 法 时 ， 可 以 获得 ActionInvocation 参 

提示 | 。” 数 ， 这 个 参数 又 可 以 获得 被 拦截 的 Action 实例 ， 一 旦 取得 了 Action 实例 ， 几 乎 获 
得 了 全 部 的 控制 权 : 可 以 实现 将 HTTP 请 求 中 的 参数 解析 出 来 ， 设 置 成 Action 的 
属性 (这 是 系统 params 拦截 器 干 的 事情 ); 也 可 以 直接 将 HTTP 请求 中 的 
HttpServletRequest 实例 和 HttpServletResponse 实例 传 给 Action( 这 是 servlet-config 
拦截 器 干 的 事情 )…… 当然 ， 也 可 实现 应 用 相关 的 逻辑 。 


2. 使 用 自 定义 拦截 器 
使 用 自 定义 拦截 器 需要 两 个 步骤 。 


< 人 mm 
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(1) 通过 <interceptor.../> 元 素来 定义 拦截 器 。 
(2) 通过 <interceptor-ref .. 人 > 元 素来 使 用 拦截 器 。 
为 了 给 读者 以 清晰 的 讲解 ， 对 于 上 面 自 定义 的 拦截 器 类 ， 其 配置 代码 如 下 。 


<?xXml Version="1.0"” encoding="UTF-8" ?> 

<!-- 指定 拦截 器 的 DTD 信息 --> 

<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 

<struts> 
<!-- 通过 常量 配置 struts 2 所 使 用 的 解码 集 --> 


<constant name="struts.il8n.encoding" value="gbk" /> 


<constant name="struts.devMode" value="true" /> 
<include file ="struts-default.xml" /> 
<package name="intercep" namespace="/intercep" extends="struts-default"> 
<!-- 配置 应 用 所 用 的 拦截 器 --> 
<interceptors> 
<!-- 配置 mysimple 拦截 器 --> 
<interceptor name="mysimple" class="SimpleInterceptor"> 
<!-- 为 拦截 器 指定 参数 值 --> 
<param name="name"> 简 单 拦截 器 </param> 
</interceptor> 
</interceptors> 
<!-- 配置 自 定义 的 Action， 实 现 类 为 com.myinterceptor.LoginAction 一 -> 
<action name="login" class="com.myinterceptor.LoginAction"> 
<!-- 配置 该 Action 的 两 个 局 部 结果 --> 
<result name="error">/error.jsp</result> 
<result name="success">/success.jsp</result> 
<!-- 拦截 器 一 般配 置 在 result 元 素 之 后 --> 
<interceptor-ref name="defaultstack"/> 
<!-- 为 Action 配置 拦截 器 --> 
<interceptor-ref name="mysimple"> 
<param name="name"> 改 名 后 的 拦截 器 </param> 
</interceptor-ref> 
</action> 
</package> 
</struts> 


通过 上 面 的 配置 文件 ， 将 SimpleInterceptor 拦截 器 类 定义 成 名 为 “mysimple ”的 拦截 器 ， 
并 在 名 为 login 的 Action 中 使 用 该 拦截 器 。 值 得 注意 的 是 ， 当 配置 mysimple 拦截 器 时 ， 需 要 了 
动 引 用 系统 默认 的 defaultStack 拦截 器 栈 。 
$ 前 面 已 经 讲 过 ， 如 果 为 Action 指定 一 个 拦截 器 ， 则 系统 默认 的 拦截 器 栈 将 会 失 
注意 去 作用 .。 为 了 继续 使 用 默认 拦截 器 ,所 以 上 面 的 配置 文件 中 手动 引入 了 默认 的 拦 
截 器 。 


m 
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5.2.2 ”实例 描述 


当 我 们 做 了 一 个 后 台 管理 系统 后 ， 并 且 该 管理 系统 为 一 个 企业 的 内 部 系统 ， 那 么 是 否 每 个 
人 都 可 以 登录 , 都 可 以 进入 到 管理 系统 的 主页 面 呢 ? 那么 是 否 可 以 对 该 系统 进行 操作 呢 ? 这 样 
后 果 不 堪 设想 ， 因 此 一 个 程序 的 “ 门 ” 至 关 重要 ， 用 于 拦截 非法 登录 的 用 户 。 


5.2.3 ”实例 应 用 


【 例 5-2】 为 程序 做 扇 “ 门 ”。 
(1) 编辑 LoginAction 类 ， 代 码 如 下 。 


package com.struts2.actions; 
import com.opensymphony.xwork2.ActionSupport; 
public class LoginAction extends RARctionSupport { 
private static final long serialVersionUID = -4278369739741451645L; 
private String username;// 用 户 名 
private String pass;// 密 码 
@Override 
public String execute() throws Exception { 
return “main™"; 
} 
/* 下 面 是 username 和 pass 的 get、set 方法 ， 在 此 省 略 了 */ 


(2) 接着 编辑 拦截 LoginAction 的 拦截 器 类 ， 判 断 用 户 是 否 合法 ， 代 码 如 下 。 
package com.struts2.interceptor; 
import java.util.Date; 
import javax.servlet.http.HttpServletRequest; 
import org.apache.struts2.ServletActionContext; 
import com.opensymphony .xwork2.ActionInvocation; 
import com.opensymphony .xwork2.interceptor.AbstractInterceptor; 
import com.struts2.actions.LoginAction; 
public class SimpleInterceptor extends AbstractInterceptor { 
// 定 义 拦截 器 名 称 
private String name; 
public void setName (String name) 
{ 
this.name = name; 
} 
public String intercept (ActionInvocation invocation)throws Exception 
{ 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request=ServletActionContext .getRequest () 7 


// 获 取 被 拦截 的 Action 实例 
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LoginAction action = (LoginAction)invocation.getAction(); 

System.-out .println (name+" 拦 截 器 的 动作 :开始 执行 登录 Action 的 时 间 为 : "+new 
Date()); 

// 把 得 到 的 username 赋 给 LoginAction 中 的 username 属性 

action.setUsername (request .getParameter ("username")); 

action.setPass (request .getParameter ("pass")); 


// 判 断 用 户 是 否 是 合法 用 户 
if(!action.getUsername() .equals ("admin") ||!action.getPass() .equals 
("admin")) 
{ 
System.out.println("user name error"); 
return "input"; 
3 
// 获 取 开 始 时 间 
long start = System.currentTimeMillis(); 
String result = invocation.invoke(); 
System.out.println (name+" 拦 截 器 的 动作 : 执行 完 登 录 Action 的 时 间 为 : ”+ new 
Date ()); 
// 获 取 结 束 时 间 
long end = System.currentTimeMillis(); 
System.out .println ("拦截 器 的 动作 : 执行 action 事件 的 时 间 是 :"+ (end-start)+" 
毫秒 ") ; 


return result; 


有 


(3) 在 src 下 的 struts-config 文件 夹 中 新 建 login.xml， 配 置 Action 和 Action 的 拦截 器 ， 代 
码 如 下 。 
<?xml] version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<package name ="login" extends ="struts-default" > 
<interceptors> 
<interceptor name="loginInterceptor" 
class="com.struts2.interceptor.SimpleInterceptor"> 
<!-- 为 拦截 器 指定 参数 值 --> 
<param name="name"> 简 单 拦截 器 </param> 
</interceptor> 
</interceptors> 
<action name ="login" class ="com.struts2.actions.LoginAction" > 
<result name="main">/main.jsp</result> 
<result name="input">/login.jsp</result> 
<!-- 在 Action 中 引用 拦截 器 --> 
<interceptor-ref name="loginInterceptor"> 


<param name="name"> 改 名 后 的 拦截 器 </param> 
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</interceptor-ref> 
</action > 
</package > 
</struts> 


(4) 编辑 登录 页 面 loginjsp， 代 码 如 下 。 


<form name=forml action="login/login.action" method=post> 
<input type="text" name="username"/> 
<input type="text" name="pass"/> 
<input type="submit" value=" .2 

</form> 


(5) 编辑 登录 成 功 页 面 main.jsp。 
5.2.4 运行 结果 
运行 login.jsp 页 面 ， 如 果 输 入 的 密码 不 是 “admin”， 单 击 “ 登 录 ” 按 钮 返回 本 页 面 ， 如 


图 5-3 所 示 。 如 果 输 入 的 用 户 名 和 密码 都 是 “admin”， 登 录 成 功 ， 跳 转 至 main.jsp 页 面 ， 如 
图 5-4 所 示 。 
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图 5-4 登录 成 功 ， 跳 转 至 主页 面 
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不 要 光顾 着 表面 工作 ， 我 们 再 来 看 看 控制 台 输 出 ， 如 图 5-5 所 示 。 


生 守 总 对 
促 的 于 加 是 .0 村 和 
开始 执行 天 杂 Aet4on 的 时 间 为 :mon 


著 行 完 必 时 hes en 的 时 间 为 on oce 1 
件 的 对 介 是 :0 王权 | 


5-5 ”控制 台 输 出 


5.2.5 “实例 分 析 


a 


在 上 述 和 案例 中 ， 在 拦截 器 类 SimpleInterceptor 中 给 LoginAction 类 的 两 个 属性 username 和 
pass 赋值 ， 读 者 可 能 会 问 在 拦截 器 类 中 既然 已 经 得 到 了 要 拦截 的 Action 类 LoginAction， 不 就 
是 得 到 了 它 的 两 个 属性 了 吗 ? 答案 是 错 的 。 在 这 里 根本 得 不 到 其 属性 ， 因 为 拦截 器 是 在 执行 
Action 之 前 执行 的 ， 在 此 之 前 LoginAction 未 执行 ,因此 要 想 在 拦截 器 类 中 得 到 页 面 中 的 元 素 ， 
需要 用 request.getParameter() 方 法 来 获取 。 


5.3 ”拦截 器 深度 剖析 


前 面 介绍 了 Struts 2 拦截 器 的 原理 、 配 置 和 简单 使 用 ， 本 节 将 对 拦截 器 进行 深入 的 探讨 。 


7 
四 > 视频 教学 ， 光 盘 /videos/05/FunFilter.avi 长 度 : 10 分 钟 
光盘 /videos/05/PreResultListener.avi 加 长 度 : 5 分 钟 
光盘 /videos/05/FunFilter.avi 图 长 度 :10 分钟 


5.3.1 基础 知识 一 一 深度 剖析 拦截 器 

拦截 器 的 配置 离 不 开 前 面 介绍 的 <interceptor.../>、<interceptor-ref.../> 和 <interceptor- 
stack.../> 元 素 。 但 对 于 深入 拦截 器 的 配置 方面 ， 还 有 一 些 值得 注意 的 地 方 。 

1. 方法 过 滤 

在 默认 情况 下 ， 如 果 为 某 个 Action 定义 了 拦截 器 ， 则 这 个 拦截 器 会 拦截 该 Action 内 的 所 
有 方法 。 在 有 些 情况 下 ， 也 许 无 需 拦 截 所 有 的 方法 ， 只 需要 拦截 某 些 方法 ， 此 时 就 需要 使 用 
Struts 2 拦截 器 的 方法 过 滤 特 性 。 
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为 了 实现 方法 过 滤 的 特性 ，Struts 2 提供 了 一 个 MethodFilterInterceptor 类 ， 该 类 是 
AbstractInterceptor 类 的 子 类 ， 如 果 用 户 需要 自己 实现 的 拦截 器 支持 方法 过 滤 特 性 ， 则 应 该 继承 
MethodFilterInterceptor 类 。 该 类 需要 实现 一 个 方法 (在 MethodFilterInterceptor.java 类 中 的 方法 )。 

protected String doIntercept (ActionInvocation ai) throws Exception 1{ 

// TODO Ruto-generated method stub 


return null; 


} 
从 上 面 的 代码 可 以 看 出 ,拦截 器 的 拦截 逻辑 与 前 面 介绍 的 简单 拦截 器 的 拦截 逻辑 相同 ， 只 
是 之 前 需要 重 写 intercept0 方 法 ， 现 在 需要 重 写 dolIntercept0 方 法 。 
实际 上 ， 实 现 方法 过 滤 的 拦截 器 与 实现 普通 拦截 器 并 没有 太 大 的 区 别 ， 只 需要 注意 两 个 方 
面 : 实现 方法 过 滤 的 拦截 器 需要 继承 MethodFilterInterceptor 抽象 类 ， 并 且 重 写 doIntercept() 方 
法 对 Action 定义 的 拦截 逻辑 。 
在 MethodFilterInterceptor0 方 法 中 ， 额 外 增加 了 如 下 两 个 方法 。 
@ public void setExcludeMethods(String excludeMethods): 排除 需要 过 滤 的 方法 一 一 设置 
方法 “ 黑 名 单 ”， 所 有 在 excludeMethods 字符 串 中 列 出 的 方法 都 不 会 被 拦截 。 
@ public void setIncludeMethods(String includeMethods): 设置 需要 过 滤 的 方法 
法 “ 白 名 单 ”， 所 有 在 includeMethods 字符 串 中 列 出 的 方法 都 会 被 拦截 。 


”如 果 一 个 方法 同时 在 excludeMethods 和 includeMethods 中 列 出 ， 则 该 方法 会 被 
注意 拦截 。 


因为 MethodFilterInterceptor 类 包含 了 如 上 两 个 方法 , 所 以 该 拦截 器 的 子 类 也 会 获得 这 两 个 
方法 。 可 以 在 配置 文件 中 指定 需要 被 拦截 或 者 不 需要 被 拦截 的 方法 。 
<interceptors> 
<interceptor name=" 拦 截 器 名 ”class=" 拦 截 器 类 "/> 
</interceptors> 
<action name="Action 名 "class="Action 类 "> 
<interceptor-ref name=" 拦 截 器 名 "> 
<!-- 指定 execute 方法 不 需要 被 拦截 --> 
<param name="excludeMethods">execute</param> 
</interceptor-ref> 


设置 方 


</action> 


在 上 面 的 配置 文件 中 ， 通 过 excludeMethods 属性 指定 了 execute0 方 法 ， 无 须 被 拦截 。 
如 果 需 要 同时 指定 多 个 方法 不 被 拦截 器 拦截 ， 则 多 个 方法 之 间 以 英文 逗号 () 隔 开 。 如 下 
所 示 。 


<interceptor-ref name=" 要 引用 的 拦截 器 名 "> 
<!-- 指定 方法 一 、 方 法 二 、 方 法 三 不 需要 被 拦截 --> 
<param name="excludeMethods"> 方 法 一 ,方法 二 ,方法 三 </param> 
</interceptor-ref> 
如 果 excludeMethods 参数 和 includeMethods 参数 同时 指定 了 一 个 方法 名 , 则 拦截 器 会 拦截 
该 方法 ， 如 下 所 示 。 
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<interceptor-ref name=" 要 引用 的 拦截 器 名 "> 
<!-- 指定 方法 一 、 方 法 二 、 方 法 三 不 需要 被 拦截 --> 
<param name="excludeMethods"> 方 法 一 ,方法 二 ,方法 三 </param> 
<!-- 指定 方法 一 需要 被 拦截 --> 
<param name="includeMethods"> 方 法 一 </param> 
</interceptor-ref> 


@ 上面 配 置 中 通过 excludeMethods 参数 指定 了 方法 一 、 方 法 二 和 方法 三 不 需要 被 拦 
注意 堆 ， 又 通过 includeMethods 参数 指定 了 方法 一 需要 拦截 一 一 二 者 冲突 以 include 
Methods 参数 指定 的 取胜 ， 即 拦截 器 会 拦截 方法 一 。 


2. 拦截 监听 的 结果 

在 前 面 的 简单 拦截 器 中 ,我 们 将 在 execute0 方 法 执行 之 前 、 执 行 之 后 的 动作 都 定义 在 拦截 
器 的 intercepte(ActionInvocation invocation) 方 法 中 ， 这 种 方式 使 结构 看 上 去 不 够 清晰 。 

为 了 精确 定义 在 execute() 方 法 执行 结束 后 再 处 理 Result 执行 的 动作 ，Struts 2 提供 了 用 于 
拦截 结构 的 监听 器 ， 这 个 监听 器 是 通过 手工 注册 到 拦截 器 内 部 的 。 

实现 拦截 结构 的 监听 器 必须 实现 PreResultListener 接口 ， 其 代码 如 下 。 

public class MyPreResultListener implements PreResultListener 1{ 

// 定 义 在 处 理 Result 之 前 的 行为 


public void beforeResult (ActionInvocation invocation,Sstring resultCode){ 


// 打 印 出 执行 结果 
System.out .println ("最 后 的 逻辑 视图 为 "+resultCode); 


i 

与 前 面 直接 在 intercepte 方法 中 定义 的 ， 在 execute0 方 法 执行 之 后 执行 的 代码 相 比 ， 在 
beforeResult0 方 法 内 有 了 另外 一 个 参数 :resultCode， 这 个 参数 就 是 被 拦截 Action 的 execute0 
方法 的 返回 值 。 上 面 的 监听 器 仅仅 打印 了 被 拦截 的 Action 中 的 execute0 方 法 的 返回 值 。 

虽然 上 面 的 beforeResult( 方 法 也 获得 ActionInvocation 类 型 的 参数 ， 但 通过 这 个 参数 来 控 
制 Action 的 作用 已 经 不 再 那么 明显 一 一 因为 Action 的 execute() 方 法 已 经 执行 完了 。 

监听 器 需要 通过 代码 手动 注册 给 某 个 拦截 器 ， 需 要 在 拦截 器 类 中 的 intercept 
(ActionInvocation invocation) 方 法 中 加 上 下 面 代码 进行 注册 监听 器 。 


invocation.addPreResultListener (new MyPreResultListener()); 


通过 代码 手动 注册 了 一 个 拦截 结果 的 监听 器 MyPreResultListener， 该 监听 器 中 的 before 
Result(0 方 法 肯定 会 在 系统 处 理 Result 之 前 执行 。 
虽然 在 beforeResult0 方 法 中 再 对 ActionInvocation 方法 处 理 已 经 没有 太 大 的 作用 ， 但 是 
Action 已 经 执行 完毕 ， 而 Result 还 没有 开始 执行 的 时 间 点 也 非常 重要 ， 可 以 让 开发 者 精确 控制 
到 Action 处 理 的 结果 ， 并 且 对 处 理 结果 做 出 针对 性 的 处 理 。 
$》 虽然 beforeResult( 方 法 中 也 可 获得 ActionInvocation 实例 , 但 不 能 通过 该 实例 再 次 
注意 调用 invoke0 方 法 , 如 果 再 次 调用 invoke() 方 法 , 将 会 再 次 执行 Action 处 理 , Action 
处 理 之 后 紧 跟 的 是 beforeResult(0 方 法 …*… 这 会 陷入 一 个 死 循环 。 
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3. 覆盖 拦截 器 中 特定 拦截 器 的 参数 


有 些 时 候 ，Action 需要 引用 一 个 拦截 器 栈 ， 当 引用 这 个 拦截 器 栈 时 ， 又 需要 履 盖 这 个 拦截 
器 栈 中 某 个 拦截 器 的 特定 参数 。 
<interceptors> 
<!-- 配置 第 一 个 拦截 器 --> 
<interceptor name=" 拦 截 器 一 ”class=" 拦 截 器 一 类 "> 
<!-- 为 拦截 器 指定 参数 值 --> 
<param name="name"> 拦 截 器 一 </param> 
</interceptor> 
<!-- 配置 第 二 个 拦截 器 --> 
<interceptor name=" 拦 截 器 二 "” class=" 拦 截 器 二 类 "/> 
<!-- 配置 拦截 器 栈 --> 
<interceptor-stack name=" 拦 截 器 栈 "> 
<!-- 配置 拦截 器 战 中 的 第 一 个 拦截 器 --> 
<interceptor-ref name=" 拦 截 器 一 "> 
<param name="name"> 第 一 个 </param> 
</interceptor-ref> 
<!-- 配置 拦截 器 栈 中 的 第 二 个 拦截 器 --> 
<interceptor-ref name=" 拦 截 器 二 "> 
<param name="name"> 第 二 个 </param> 
</interceptor-ref> 
</interceptor-stack> 
</interceptors> 
<action name="Action 名 "class="Action 类 "> 
<!-- 引用 上 面 的 拦截 器 栈 --> 
<interceptor-ref name=" 拦 截 器 栈 "/> 
</action> 


在 上 面 的 代码 中 ， 配 置 了 一 个 名 为 “拦截 器 栈 ” 的 拦截 器 栈 ， 这 个 拦截 器 栈 包含 两 个 拦截 
器 ， 这 两 个 拦截 器 分 别 引用 “拦截 器 一 ”和 “拦截 器 二 ”的 拦截 器 ， 并 且 履 盖 了 “拦截 器 一 ” 
的 默认 参数 。 在 Action 中 使 用 拦截 器 栈 时 ， 并 未 覆盖 拦截 器 栈 中 的 任何 拦截 器 的 参数 。 

如 果 需 要 覆盖 “拦截 器 二 ”中 的 name 属性 值 ， 最 容易 的 方法 就 是 在 引用 拦截 器 栈 的 
<interceptor-ref.../> 元 素 中 增加 <param.../> 子 元 素 ， 即 将 配置 Action 的 配置 片段 修改 成 如 下 
形式 。 

<action name="Action 名 " class="Rction 类 "> 

<!-- 引用 上 面 的 拦截 器 栈 --> 
<interceptor-ref name=" 拦 截 器 栈 "> 

<param name="name"> 改 名 后 的 拦截 器 </param> 
</interceptor-ref> 

</action> 

聪明 一 点 的 读者 应 该 会 看 出 来 这 样 写 有 些 不 妥 。 因 为 系统 无 法 确认 需要 修改 的 name 属性 
到 底 是 该 拦截 器 栈 中 的 哪个 拦截 器 ， 显 然 ， 这 种 配置 方法 是 不 成 功 的 。 实 际 上 ， 通 过 这 种 方式 
无 法 修改 该 拦截 器 栈 内 任何 拦截 器 的 name 属性 。 


< 
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对 此 可 以 采用 最 原始 的 方法 : 在 Action 配置 中 重新 引用 所 有 的 拦截 器 , 在 引用 第 二 个 拦截 
器 时 修改 第 二 个 拦截 器 的 name 属性 。 代 码 如 下 。 


<action name="Action 名 " class="Rction 类 "> 
<!-- 分 别 引 用 两 个 拦截 器 --> 
<interceptor-ref name=" 拦 截 器 一 "/> 
<interceptor-ref name=" 拦 截 器 二 "> 
<param name="name"> 改 名 后 的 拦截 器 </param> 
</interceptor-ref> 
</action> 


通过 上 述 方式 , 确实 可 以 实现 修改 拦截 器 栈 内 特定 拦截 器 的 属性 值 。 但 这 种 配置 方式 的 缺 
点 很 明显 , 即 如 果 该 拦截 器 栈 内 包含 了 10 个 拦截 器 , 则 必须 在 该 Action 内 重新 引用 10 个 拦截 
器 一 一 这 一 点 ， 与 我 们 一 直 强 调 的 软件 复 用 是 矛盾 的 。 

为 了 解决 这 个 问题 ，Struts 2 提供 了 一 种 简单 的 修改 方式 : 当 引 用 拦截 器 栈 时 ， 直 接 修改 
该 栈 内 特定 的 拦截 器 的 属性 值 。 代 码 如 下 。 

<action name="Action 名 "” class="Rction 类 "> 

<!-- 引用 上 面 的 拦截 器 栈 --> 
<interceptor-ref name=" 拦 截 器 栈 "> 
<param name=" 拦 截 器 二 .name"> 改 名 后 的 拦截 器 </param> 


</interceptor-ref> 
</action> 


从 上 面 的 配置 片段 中 可 以 看 出 , 如 果 需 要 在 引用 拦截 器 栈 时 直接 覆盖 栈 内 某 个 拦截 器 的 属 
性 值 ， 则 在 制定 需要 被 赋 给 的 属性 时 ， 不 能 只 制定 该 属性 的 属性 名 ， 必 须 加 上 该 属性 属于 的 拦 
截 器 名 。 即 采用 如 下 方式 。 

< 拦截 器 名 > .< 参数 名 > 


5.3.2 ”实例 描述 


最 近 ， 做 了 一 个 企业 的 后 台 管理 系统 ， 而 这 个 后 台 管理 系统 需要 有 权限 控制 ， 即 很 多 功能 
是 只 有 超级 管理 员 才 有 操作 权限 ， 普 通用 户 只 有 查看 的 权限 ， 而 这 时 ， 使 用 Struts 2 中 的 拦截 
器 过 滤 方 法 可 以 实现 此 功能 ， 同 时 为 了 便于 其 他 员工 的 合作 将 拦截 结果 返回 ， 下 面 来 为 后 台 管 
理 系统 加 一 道 安全 锁链 吧 ! 


5.3.3 ”实例 应 用 


【 例 5-3】 为 后 台 管 理 系 统 加 上 安全 锁链 。 

讲 这 个 例子 之 前 , 我 先 表 个 态 吧 …… 为 了 使 读者 清晰 、 客 观 地 了 解 到 怎样 为 后 台 管 理 系统 
加 上 权限 控制 ， 我 在 这 里 只 是 模拟 一 下 ， 并 没有 与 数据 库 连接 ， 当 然 这 也 是 为 了 方便 考虑 但 是 
我 的 思路 非常 清晰 ， 读 者 看 完 后 会 明白 的 。 

(1) 既然 是 Struts 2， 并 且 是 页 面 ，Web 层 是 必须 的 。 首 先 创 建 UserAction 类 ， 继 承 
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ActionSupport 类 ， 它 里 面 有 两 个 方法 ， 一 个 是 显示 所 有 用 户 信息 的 execute 0， 另 一 个 是 删除 
用 户 信息 的 方法 deleteUser 0， 代 码 如 下 。 


package com.struts2.actions; 
import com.opensymphony .xwork2.Actionsupport; 
public class UserAction extends ActionSsupport { 
// 删 除 用 户 
public String deleteUser(){ 
// 记 录 执 行 否 
System.out.println ("我 执行 了 deleteUser， 删 除了 一 条 用 户 人 信息， 呵呵 … 


return "user"™; 


} 

Beoverride 

public String execute () throws Exception { 
// 记 录 执 行 否 
System.out .println(" 我 执行 了 execute 方法 "); 
return "user"™; 


1 
(2) 创建 一 个 拦截 结果 的 监听 器 类 UserPreResultListenerjava， 输 出 结果 ， 代 码 如 下 。 


package com.struts2.interceptor; 
import com.opensymphony .xwork2.ActionInvocation; 
import com.opensymphony .xwork2.interceptor.PreResultListener; 
public class UserPreResultListener implements PreResultListener { 
// 定 义 在 处 理 Result 之 前 的 行为 
public void beforeResult (ActionInvocation invocation, String result) { 
// 打 印 出 执行 的 结果 
System.out.println ("返回 的 逻辑 视图 为 "+result); 


; 


(3) 最 关键 的 一 步 , 创建 方法 过 滤 的 拦截 器 类 MyFilterInterceptor.java， 记 录 执 行 过 程 ， 并 
把 上 面 的 监听 器 通过 代码 手动 注册 给 拦截 器 ， 代 码 如 下 。 


package com.struts2.interceptor; 
import java.util.Date; 
import com.opensymphony .xwork2.ActionInvocation; 
import com.opensymphony .xwork2.interceptor.MethodFilterIinterceptor; 
import com.struts2.actions.UserAction; 
public class MyFilterIinterceptor extends MethodFilterIinterceptor { 
// 定 义 拦截 器 的 名 字 
private String name; 
public String getName() { 
return name; 
} 
public void setName (String name) { 


this.name = name; 


<@——— 
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@Override 
protected string doIntercept (ActionInvocation invocation) throws Exception 


System.out.println("—————————————— MyFilterInterceptor 拦截 器 开始 


// 获 取 被 拦截 的 Action 实例 

UserAction action = (UserAction)invocation.getAction(); 

System.out .println (name+" 拦 截 器 的 动作 :开始 执行 删除 用 户 deleteUser 的 时 间 为 : 
"+new Date()); 

// 获 取 开 始 执行 Action 方法 的 开始 时 间 

long start = System.currentTimeMillis(); 

// 将 一 个 拦截 结果 的 监听 器 注册 给 该 拦截 器 

invocation.addPreResultListener (new UserPreResultListener()); 

System.out.println ("deleteUser 方法 执行 之 前 的 拦截 ") ; 

String result = invocation.invoke(); 

System.out .println (name+" 拦 截 器 的 动作 : 执行 完 删 除 用 户 deleteUser 的 时 间 为 : 
"+ new Date()); 

// 获 取 结 束 时 间 

long end = System.currentTimeMillis(); 


System.out .println(" 拦 截 器 的 动作 : 执行 action 事件 的 时 间 是 :"+ (end-start)+" 


Svaten: Out printin(" -= 结束 --------------- 人 
return result; 


(4) 工作 即将 完成 ， 现 在 将 过 滤 方 法 的 拦截 器 在 struts-config 文件 夹 下 的 user.xml 文件 中 
配置 一 下 。 
<?Xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<package name ="user" extends ="struts-default" > 
<interceptors> 
<interceptor name="myfilter" 
class="com.struts2.interceptor.MyFilterIinterceptor"> 
<!-- 为 拦截 器 指定 参数 值 --> 
<param name="name"> 方 法 过 滤 拦 截 器 </param> 
</interceptor> 
</interceptors> 
<action name ="user" class ="com.struts2.actions.UserAction" > 
<result name="user">/user.jsp</result> 
<!-- 在 Action 中 引用 拦截 器 --> 
<interceptor-ref name="myfilter"> 
<param name="name"> 改 名 后 的 拦截 器 </param> 
<!-- 指定 execute 方法 不 需要 被 拦截 --> 


<param name="excludeMethods">execute</param> 
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</interceptor-ref> 
</action > 
</package > 
</struts> 


(5) 在 struts.xml 文件 中 引入 user.xml 文件 。 

(6) 编辑 userjsp， 用 于 显示 所 有 的 管理 员 列 表 信 息 。 一 般 情况 下 可 以 从 数据 库 中 读 取 ， 
得 到 一 个 用 户 集合 ,然后 把 这 个 用 户 集合 List 保存 至 request 对 象 中 ,在 页 面 中 用 Struts 2 标签 
中 的 <s:iterator... 人 遍历 集合 显示 ， 这 里 不 再 写 明代 码 。 


5.3.4 运行 结果 


单 击 左边 导航 中 的 “管理 员 列 表 ”， 链 接地 址 为 user/user.action， 右 边 显示 user.jsp 页 面 ， 
如 图 5-6 所 示 。 
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5-6 ”管理 员 列 表 
单 击 图 5-6 中 的 “删除 ”按钮 ， 执 行 方法 过 滤 的 拦截 器 类 MyFilterInterceptor.java 中 的 
doIntercept(ActionInvocation invocation) 方 法 ， 后 台 输 出 结果 如 图 5-7 所 示 。 


Emal ET re Servers 目 coresle 5 [EFTET LIGETI)| 
enedS erver [Renote Java Applicstion] 0: IFrogrm Tiles\Juva\jdkl. 6 0_I0\Dia\avar ere (2010-10-12 上 秆 10:21:03] 


| 了 execure 方 法 


强 开 始 
ee 1 lotssto csr 2010 
和 

我 执行 了 dalecsuaer， 删 除了 一 条 用 户 信息 ， 回 名. 
过 加 的 浊 扣 机 为 wc: 
导入 站 的 友人 区 全 时 耳语 eleseee: 的 时 间 为: Tve Ose 22 10:25:00 caT 2019 
拉 规 计 的 时 间 是 :0 对 种 


5-7 后 台 输 出 


< 
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5.3.5 ”实例 分 析 


i 


上 述 案 例 中 ， 在 struts.xml 中 配置 了 方法 过 滤 拦 截 器 类 MyFilterInterceptorjava， 它 要 拦截 
的 Action 为 UserAction ， 而 在 userxml 文件 中 编辑 <param name="excludeMethods"> 
execute</param>， 使 UserAction 中 的 execute() 方 法 不 要 拦截 ， 也 就 说 只 拦截 deleteUser() 方 法 。 
故 当 执 行 user/user.action 时 ,后 台 只 输出 “我 执行 了 execute() 方 法 ”, 而 不 执行 MyFilterInterceptor 
类 中 的 doIntercept(ActionInvocation invocation) 方 法 ， 当 单 击 “ 人 删除 ”按钮 ， 执行 user/user! 
deleteUser.action 时 ， 执 行 MyFilterInterceptor 类 中 的 doIntercept(ActionInvocation invocation) 方 
法 ， 同 时 返回 拦截 结果 “返回 的 逻辑 视图 为 user”。 


5.4 _ Struts 2 内 置 拦 截 器 


俗话 说 : 金 无 足 赤 ， 人 无 完 人 。 

如 今 ， 哪 个 软件 在 广大 人 群 中 已 占据 了 不 可 或 缺 的 地 位 ? 腾讯 QQ。 

腾讯 QQ 空间 装扮 中 用 户 可 以 用 腾讯 内 部 自 带 的 色调 、 模 块 、 布 局 …… 装 扮 自己 的 空间 ， 
也 可 以 自 定义 上 传 自己 想 要 的 图 片 进 行 装扮 ; 腾讯 QQ 头像 可 以 用 腾讯 内 部 自 带 的 QQ 头像 更 
换 自 己 的 QQ 头像 ， 也 可 以 自己 上 传 头像 进行 更 换 头 像 ， 腾 讯 QQ 聊天 窗 体 皮肤 可 以 用 腾讯 内 
部 自 带 的 皮肤 , 也 可 以 自 定义 自己 想 要 的 皮肤 颜色 ……' 总 而 言 之 , 腾讯 在 这 一 方面 做 到 了 完美 。 

Struts 2 作为 Web 开发 中 最 流行 的 框架 , 它 的 成 功 和 腾讯 一 样 , 是 属于 “实力 派 ”的 , Struts 2 
中 的 拦截 器 也 存在 自 定义 拦截 器 和 内 置 拦截 器 之 分 ， 下 面 将 为 读者 讲解 一 下 Struts 2 的 内 置 拦 
截 器 。 


A9 
革 >， 视频 教学 ， 光盘/videos/05/SystemInterceptor.avi 多 长 度 : 7 分 钙 


5.4.1 基础 知识 一 一 内 置 拦截 器 


从 Struts 2 框架 来 看 ， 拦 截 器 几乎 完成 了 Struts 2 框架 70% 的 工作 , 包括 解析 请 求 参数 ， 将 
请 求 参数 赋值 给 Action 属性 ， 执 行 数据 校 验 ， 文 件 上 传 …… Struts 2 设计 的 灵巧 性 ， 更 大 程度 
地 得 益 于 拦截 器 设计 ， 当 需要 扩展 Struts 2 功能 时 ， 只 需要 提供 对 应 的 拦截 器 ， 并 将 它 配置 在 
Stmuts 2 容器 中 即 可 ; 如 果 不 需 要 该 功能 时 ， 也 只 需要 取消 该 拦截 器 的 配置 即 可 。 这 种 可 插 拔 
式 的 设计 ， 正 是 软件 设计 领域 一 直 孜 孜 以 求 的 目标 。 

Struts 2 框架 的 大 部 分 工作 都 是 通过 内 建 拦截 器 完成 的 。 

1. 内 置 拦 截 器 

Struts 2 内 置 了 大 量 的 拦截 器 ， 这 些 拦截 器 以 key-value 对 的 形式 配置 在 struts-default.xml 
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文件 中 ， 其 中 name 是 拦截 器 的 名 字 ， 就 是 后 面 使 用 该 拦截 器 的 引用 点 ; value 则 指定 了 该 拦截 
器 的 实现 类 ,如果 定义 的 package 继承 了 Struts 2 的 默认 struts-default 包 ， 则 可 以 自由 使 用 下 面 
的 拦截 器 ， 否 则 必须 自 定义 这 些 拦截 器 。 


下 面 就 来 给 读者 介绍 一 下 Struts 2 的 内 置 拦截 器 ， 如 表 5-1 所 示 。 


表 5-1 Struts 2 的 内 置 拦截 器 


拦截 器 名 功 能 
alias 实现 在 不 同 请 求 中 相似 参数 别名 的 转换 
本 这 是 个 自动 装配 的 拦截 器 ， 主 要 用 于 当 Struts 2 和 Spring 整合 时 ，Struts 2 可 以 使 用 
es 自动 装配 的 方式 来 访问 Spring 容器 中 的 Bean 
a 构建 一 个 Action 链 , 使 当前 Action 可 以 访问 前 一 个 Action 的 属性 ,一 般 和 <result type= 
“chain” ... 人 > 一 起 使 用 
ER 这 是 一 个 负责 处 理 类 型 转换 错误 的 拦截 器 ， 它 负责 将 类 型 转换 错误 从 Action Context 
中 取出 ， 并 转换 成 Action 的 FieldError 错误 
Rs 该 拦截 器 负责 创建 一 个 HttpSession 对 象 , 主要 用 于 那些 需要 有 HttpSession 对 象 才能 
正常 工作 的 拦截 器 中 
debugging 当 使 用 Struts 2 的 开发 模式 时 ， 这 个 拦截 器 会 提供 更 多 的 调试 信息 
execAndWait 后 台 执行 Action， 负 责 将 等 待 画面 发 送 给 用 户 
exception 这 个 拦截 器 负责 处 理 异常 ， 它 将 异常 映射 为 结果 
fileUpload 这 个 拦截 器 主要 用 于 文件 上 传 ， 它 负责 解析 表单 中 文件 域 的 内 容 
il8n 这 是 支持 国际 化 的 拦截 器 ， 它 负责 把 所 选 的 语言 、 区 域 放 入 用 户 的 Session 中 
logger 这 是 一 个 负责 日 志 记录 的 拦截 器 ， 主 要 是 输出 Action 的 名 字 
这 是 一 个 用 于 模型 驱动 的 拦截 器 ， 当 某 个 Action 类 实现 了 ModelDriven 接口 时 ， 它 
Imodel-driven 


scoped-model-driven 


params 


负责 把 getModel0 方 法 的 结果 放 入 ValueStack 中 

如 果 一 个 Action 实现 了 一 个 ScopedModelDriven 接口 ,该 拦截 器 负责 从 指定 生存 范 
围 中 找 出 指定 的 Model， 并 通过 setModel0 方 法 将 该 Model 传 给 Action 实例 

这 是 一 个 最 基本 的 拦截 器 ， 它 负责 解析 HTTP 请 求 中 的 参数 ， 并 将 参数 值 设置 成 
Action 对 应 的 属性 值 


prepare 


static-params 


如 果 Action 实现 了 Preparable 接口 ， 将 会 调用 该 拦截 器 的 prepare0 方 法 
这 个 拦截 器 负责 将 xml 中 <action> 标 签 下 的 <param> 标 签 中 的 参数 传 入 Action 


scope 


Servlet-config 


这 是 范围 转换 拦截 器 ， 它 可 以 将 Action 状态 信息 保存 到 HttpSession 范围 , 或 者 保存 
到 ServletContext 范围 中 
如 果 某 个 Action 需要 直接 访问 Servlet API， 就 是 通过 这 个 拦截 器 实现 的 


Toles 


这 是 一 个 JAAS(Java Authentication and Authorization Service，Java 授权 和 认证 服务 ) 
拦截 器 ， 只 有 当 浏 览 者 取得 合适 的 授权 后 ， 才 可 以 调用 被 该 拦截 器 拦截 的 Action 


timer 


这 个 拦截 器 负责 输出 Action 的 执行 时 间 ， 这 个 拦截 器 在 分 析 该 Action 的 性 能 瓶颈 时 
比较 多 用 


< 
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续 表 
拦截 器 名 


token 


功 能 
这 个 拦截 器 主要 用 于 阻止 重复 提交 , 它 检查 到 Action 中 的 token， 从 而 防止 多 次 提交 
这 个 拦截 器 的 作用 与 前 一 个 基本 类 似 ， 只 是 它 把 token 保存 在 HttpSession 中 
通过 执行 在 xxxAction-validation.xml 中 定义 的 校 验 器 ， 从 而 完成 数据 校 验 
这 个 拦截 器 负责 调用 Action 类 中 的 validate0 方 法 , 如 果 校 验 失败 , 则 返回 input 的 逻 
辑 视图 


token-session 


Validation 


workflow 


© 尽量 避免 在 Action 中 直接 访问 Servlet API, 否则 会 导致 Action 与 Servlet 的 高 耦合 。 


大 部 分 的 时 候 ， 开 发 者 无 需 手动 控制 这 些 拦截 器 ， 因 为 struts-default.xml 文件 中 已 经 配置 
了 这 些 拦截 器 ， 只 要 定义 的 包 继 承 了 系统 的 struts-default 包 ， 就 可 以 直接 使 用 这 些 拦截 器 。 


2. struts-defaultxml 文 件 中 的 拦截 器 配置 


struts-defaultxml 文件 是 Struts 2 默认 的 配置 文件 ， 不 管 在 什么 时 候 ， 这 个 配置 文件 都 会 自 
动 加 载 。 Struts 2 大 部 分 的 内 置 拦截 器 都 配置 在 该 文件 中 (还 有 少量 的 内 置 拦 截 器 配置 在 Struts 2 
的 插件 配置 文件 中 )。 


<interceptor name="alias" 
class="com.opensymphony .xwork2.interceptor.AliasIinterceptor"/> 
<interceptor name="autowiring" 
class="com.opensymphony .xwork2.spring.interceptor. 
ActionAutowiringInterceptor"/> 
<interceptor name="chain™" 
class="com.opensymphony .xwork2.interceptor.ChainingInterceptor"/> 
<interceptor name="conversionError" 
class="org.apache.struts2.interceptor.StrutsConversionErrorIinterceptor"/> 
<interceptor name="cookie" 
class="org.apache.struts2.interceptor.CookieInterceptor"/> 
<interceptor name="clearSession" 
class="org.apache.struts2.interceptor.ClearSessionInterceptor" /> 
<interceptor name="createSession" 
class="org.apache.struts2.interceptor.CreateSessionInterceptor" /> 
<interceptor name="debugging" 
class="org.apache.struts2.interceptor.debugging.DebuggingInterceptor" /> 
/* 省 略 更 多 的 拦截 器 配置 */ 
<interceptor name="Vvalidation" 
class="org.apache.struts2.interceptor.validation. 
AnnotationValidationInterceptor"/> 
<interceptor name="workflow" 
class="com.opensymphony .xwork2.interceptor.DefaultWorkflowInterceptor"/> 
<interceptor name="store"™" 
class="org.apache.struts2.interceptor.MessageStoreInterceptor" /> 
<interceptor name="checkbox™" 


class="org.apache.struts2.interceptor.CheckboxInterceptor" /> 
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<interceptor name="profiling" 
class="org.apache.struts2.interceptor.ProfilingActivationInterceptor" /> 

<interceptor name="roles" 
class="org.apache.struts2.interceptor.RolesInterceptor" /> 

<interceptor name="jsonValidation™ 
class="org.apache.struts2.interceptor.validation.JSONValidationInterceptor™" 
丰 > 

<interceptor name="annotationWorkflow" 
class="com.opensymphony .xwork2.interceptor.annotations. 
AnnotationWorkflowInterceptor" /> 

<interceptor name="multiselect™" 
class="org.apache.struts2.interceptor.MultiselectInterceptor" /> 


从 上 面 的 配置 片段 中 可 以 看 出 ，Struts 2 内 置 的 拦截 器 同样 采用 了 前 面 介绍 的 
<interceptor .…/> 元 素来 配置 。 当 配置 了 这 一 系列 原始 的 拦截 器 以 后 ，Struts 2 可 利用 这 些 拦截 器 
组 合 一 系列 的 拦截 器 栈 。 配 置 拦截 器 栈 的 代码 如 下 。 

<!- 最 基本 功能 拦截 器 栈 --> 


<interceptor-stack name="basicStack"> 
<interceptor-ref name="exception"/> 
<interceptor-ref name="servletConfig"/> 
<interceptor-ref name="prepare"/> 
<interceptor-ref name="checkbox"/> 


<interceptor-ref name="multiselect"/> 
<interceptor-ref name="actionMappingParams"/> 
<interceptor-ref name="params"> 
<param name="excludeParams">dojo\..*,^struts\..*</param> 
</interceptor-ref> 
<interceptor-ref name="conversionError"/> 
</interceptor-stack> 
<!-- 在 最 基本 功能 的 基础 上 增加 了 数据 校 验 拦截 器 的 拦截 器 栈 --> 
<interceptor-stack name="validationWorkflowStack"> 
<interceptor-ref name="basicstack"/> 
<interceptor-ref name="validation"/> 
<interceptor-ref name="workflow"/> 
</interceptor-stack> 
<!-- 基 本 的 JSON 验证 拦截 器 栈 --> 
<interceptor-stack name="jsonValidationWorkflowSstack"> 
<interceptor-ref name="basicStack"/> 
<interceptor-ref name="validation"> 
<param name="excludeMethods">input,back,cancel</param> 
</interceptor-ref> 
<interceptor-ref name="jsonValidation"/> 
<interceptor-ref name="workflow"/> 
</interceptor-stack> 
/* 省 略 其 他 的 拦截 器 栈 配置 */ 
<! 一 这 是 系统 默认 的 拦截 器 栈 ， 该 拦截 器 栈 可 以 满足 大 部 分 的 Struts 2 应 用 的 需要 --> 
<interceptor-stack name="defaultstack"> 


<interceptor-ref name="exception"/> 


< 人 mm 
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<interceptor-ref name="alias"/> 
<interceptor-ref name="servletConfig"/> 
<interceptor-ref name="il8n"/> 
<interceptor-ref name="prepare"/> 
<interceptor-ref name="chain"/> 
<interceptor-ref name="debugging"/> 
/* 省 略 其 他 的 拦截 器 引用 */ 
<interceptor-ref name="validation"> 
<param name="excludeMethods">input,back,cancel,browse</param> 
</interceptor-ref> 
<interceptor-ref name="workflow"> 
<param name="excludeMethods">input,back,cancel,browse</param> 
</interceptor-ref> 
</interceptor-stack> 
<! 一 这 是 系统 默认 拦截 器 栈 的 一 个 别名 ， 定 义 这 个 拦截 器 栈 仅仅 是 为 了 保持 向 后 兼容 --> 
<interceptor-stack name="CcompJeteStack"> 
<interceptor-ref name="defaultstack"/> 
</interceptor-stack> 


上 面 的 配置 片段 配置 了 开发 Struts 2 应 用 所 需要 的 大 部 分 拦截 器 栈 ， 大 部 分 时 候 ， 直 接 使 
用 系统 的 defaultStack 拦截 器 栈 即 可 ， 虽 然 它 可 能 会 做 一 些 额外 的 拦截 工作 ， 但 是 对 系统 不 会 
有 太 大 的 影响 。 当 然 如 果 读 者 有 非常 大 的 把 握 ， 也 可 以 为 每 个 Action 配置 分 别 指定 拦截 器 ,但 
这 种 工作 量 会 非常 大 。 


常 不 推荐 为 每 个 Action 分 别 定义 拦截 器 ,而 是 推荐 直接 使 用 系统 的 defaultStack 
注意 


用 户 无 须 配 置 自己 的 拦截 器 ， 甚 至 无 须 配 置 任何 拦截 器 引用 ， 因 为 Struts 2 将 defaultStack 
拦截 器 栈 配置 成 默认 的 拦截 器 栈 。 
<!-- 将 defaultstack 拦截 器 栈 配置 成 默认 的 拦截 器 栈 --> 
<default-interceptor-ref name="defaultStack"/> 
因为 Stmts 2 的 struts-default 包 中 指定 defaultStack 拦截 器 栈 时 默认 的 拦截 器 栈 ， 因 此 如 果 
用 户 定义 的 包 继 承 了 struts-default 包 ， 也 会 将 defaultStack 拦截 器 栈 作为 默认 的 拦截 器 栈 。 这 
意味 着 : 如 果 系 统 中 的 Action 配置 没有 指定 拦截 器 引用 ， 系 统 会 将 defaultStack 拦截 器 栈 自动 
作用 于 该 Action 。 
$ 也 许 是 因为 开发 者 头脑 比较 灵活 吧 ， 一 般 开 发 者 都 喜欢 用 自己 定义 的 拦截 器 ， 因 
要 示 | 此 自 定义 拦截 器 在 开发 中 很 是 “吃香 ” 啊 ! 不 过 ,读者 如 果 用 Struts 2 的 内 置 拦截 
器 能 满足 需求 ， 就 不 要 使 用 自 定义 拦截 器 了 ， 因 为 这 样 可 以 节省 时 间 。 


5.4.2 ”实例 描述 


前 几 天 看 了 一 个 太极 拳 的 网 站 ， 其 中 讲述 了 很 多 太极 拳 的 拳法 ， 我 很 是 受益 。 当 然 可 能 


mG >> 


是 “职业 病 ” 的 缘故 吧 ， 我 看 网 站 重点 并 不 在 于 网 站 的 文章 内 容 ， 而 是 在 于 网 站 的 设计 ， 其 
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中 有 一 个 功能 就 是 每 篇 文章 都 有 一 个 “访问 量 ” 统 计 ， 乍 一 看 : 哇 唑 …… 个 、 十 、 百 、 千 、 
万 …… 这 么 多 人 在 浏览 。 看 来 能 接受 这 么 大 的 访问 量 。 它 的 服务 器 质量 还 不 错 哦 ! 在 我 无 意 


按 下 F5 刷新 键 之 下 ， 再 次 回头 看 文章 访问 量 ， 次 数 加 了 一 。 


出 于 优秀 开发 者 的 角度 ， 我 还 是 试 了 一 下 ， 再 次 按 下 FS， 没 想 到 ， 访 问 量 又 加 


它 加 一 
我 按 、 按 、 按 ， 它 加 、 加 、 加 …… 怪 不 得 那么 多 的 访问 量 ， 原 来 如 此 啊 …… 


5.4.3 ”实例 应 用 


【 例 5-4】 刷新 页 面 ， 不 提交 表单 。 


(1) 新 建 用 户 实体 类 Userjava， 内 容 如 下 。 


package com.struts2.model; 


public class User { 


} 


private String username;// 用 户 名 

private String realname;// 真 实 姓名 

Private String pass;// 密 码 

private String phone;// 联 系 电话 

/* 下 面 是 上 面 所 有 属性 的 get 、set 方法 ， 这 里 省 略 */ 


心 想 可 能 是 又 有 一 个 人 访问 吧 ， 
-， 我 按 FS， 


(2) 修改 UserAction 类 ， 记 录 新 添加 的 管理 员 信息 ， 并 保存 至 List<User> 中 ， 同 时 把 所 有 
添加 的 管理 员 信息 保存 至 application 中 ， 以 供 页 面 显示 ， 修 改 后 的 代码 如 下 。 


package com.struts2.actions; 


import java.util.ArrayList; 
import java.util.List; 


import java.util.Map; 


import com.opensymphony .xwork2.ActionContext; 
import com.opensymphony .xwork2.ActionSupport; 


import com.struts2.model.User; 


public class UserAction extends Actionsupport { 


// 定 义 用 户 集合 
List<User> userList=new ArrayList<User>(); 
private User user; 
public User getUser() { 
return user; 
} 
public void setUser(User user) { 


this.user = user; 


} 
/7 删除 用 户 


public String deleteUser(){ 


< 
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System-out .println(" 我 执行 了 deleteUser， 删 除了 一 条 用 户 信息 ， 呵 呵 …") ; 
return "useIr"7 
} 
Goverride 
public String execute () throws Exception { 
System.out .println ("我 执行 了 execute 方法 "); 
return "user"™; 
} 
// 打 开 添 加 用 户 信息 
public String addUser(){ 
return "add user™; 
} 
// 添 加 用 户 信息 
public String add(){ 
// 获 取 ActionContext 对 象 
ActionContext context = ActionContext.getContext () 7 
// 获 取 application 
Map application = context.getApplication(); 
// 获 取 session 
Map session = context.getSession(); 
// 把 刚 添加 的 用 户 信息 保存 至 集合 中 
userList.add (user); 
// 判 断 是 否 是 第 一 次 添加 用 户 ， 如 果 不 是 遍历 application 中 的 集合 ,并 添加 至 用 户 集合 中 
if(application.get("users") !=null&&((List<User>)application.get("users" 
)) .size()>0){ 
for (int 
i=0;i<((List<User>)application.get ("users")) .size();i++){ 


userList.add(((List<User>)application.get ("users")) .get (i)); 
} 
;; 
// 把 用 户 集合 放 入 application 中 
application.put ("users", userList); 
session.put ("userlist", userList); 
return "add user"; 


) 


(3) 修改 sre 目录 下 的 struts-config 文件 夹 中 的 user.xml 文件 , 把 原来 的 方法 过 滤 拦 截 器 删 
除 ， 使 用 Struts 2 的 内 置 拦截 器 token， 并 配置 拦截 方法 为 UserAction 中 的 add0 方 法 ， 修 改 后 
的 userxml 文件 内 容 如 下 所 示 。 
<?xml] version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 


"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
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<package name ="user" extends ="struts-default" > 
<action name ="user" class ="com.struts2.actions.UserAction" > 
<result name="user">/user.jsp</result> 
<result name="add user">/add input.jsp</result> 
<!-- 配 置 刷新 页 面 执行 ada 方法 时 跳 转 页 面 --> 
<result name="invalid.token">/tokenError.jsp</result> 
<!-- 使 用 默认 的 拦截 器 --> 
<interceptor-ref name="defaultstack"/> 
<!-- 配置 struts2 内 置 拦截 器 --> 
<interceptor-ref name="token"> 
<!-- 配置 只 拦截 的 方法 为 add 方法 --> 
<param name="includeMethods">add</param> 
</interceptor-ref> 
</action > 
</package > 
</struts> 


(4) 在 userjsp 页 面 中 添加 按钮 ， 单 击 跳 转 至 添加 管理 员 信息 页 面 add_inputjsp。 
<a href="user/user!addUser.action"> 添 加 管理 员 </a> 
(5) 编辑 add_inputjsp 页 面 , 使 用 Struts 2 标签 中 <s:token/> 标 签 , 防止 页 面 刷新 提交 表单 ， 
代码 如 下 。 
<%@taglib prefix="s" uri="/struts-tags"%> 
<s:form action="user/user!add.action" method="post"> 
<s:textfield name="user.username"” label=" 用 户 名 "> 
</s:textfield> 
<s:textfield name="user.realname"” label=" 真 实 姓名 "> 
</s:textfield> 
<s:textfield name="user.pass"” label=" 密 码 "></s:textfield> 
<s:textfield name="user.phone" label=" 联 系 电话 "></s:textfield> 
<s:token/> 
<s:submit value=" 提交 "></s:submit> 
</s:form> 
(6) 细心 的 读者 在 上 面 的 user.xml 文件 配置 中 ， 已 经 看 到 了 这 个 功能 还 需要 一 个 页 面 
tokenErrorjsp， 即 用 于 当 用 户 刷 新 页 面 ， 并 且 要 执行 拦截 器 token 所 拦截 的 方法 add0 时 要 跳 
转 的 页 面 。 


5.4.4 ”运行 结果 


单 击 userjsp 页 面 上 的 “添加 管理 员 ”按钮 , 跳 转 至 添加 管理 员 输 入 信息 页 面 add_inputjsp， 
如 图 5-8 所 示 。 


7 


mi >> 
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图 5-8 添加 管理 员 输 入 信息 页 面 
单 击 “ 提 交 ” 按 钮 ， 查 看 管理 员 列表 页 面 ， 如 图 5-9 所 示 ， 添 加 了 一 条 新 记录 。 


5-9 ”添加 一 条 新 记录 


再 次 单 击 “ 添 加 管理 员 ” 按 钮 ， 并 输入 管理 员 信息 ， 先 单 击 “ 提 交 ” 按 钮 ， 这 时 管理 员 列 
表 肯 定 已 经 存在 你 刚 和 输入 的 管理 员 信息 了 。 刷 新 页 面 ， 会 出 现 一 个 提示 框 ， 选 择 “ 重 试 ”， 出 
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铬 作 有 误 ， 重 复 沽 交 表 单 啦 … 


图 5-10 重复 提交 表单 跳 转 至 tokenError.jsp 页 面 
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看 看 管理 员 列 表 信 息 ， 是 否 有 刷新 过 后 的 提交 数据 呢 ? 没有 ， 这 就 是 token 拦截 器 起 的 
作用 。 


5.4.5 ”实例 分 析 


ee 


在 上 述 案 例 中 ， 我 们 在 userxml 中 配置 token 拦截 器 时 ， 设 置 了 token 拦截 器 只 拦截 
UserAction 的 add() 方 法 ,使 用 了 includeMethods 参数 ， 因 此 当 单 击 左边 导航 “管理 员 列 表 ” 和 
单 击 user.jsp 页 面 中 的 任何 一 个 按钮 时 都 不 会 被 token 拦截 器 拦截 ， 而 当 我 们 要 添加 管理 员 信人 
息 时 ， 也 就 是 执行 add0 方 法 时 会 被 token 拦截 器 拦截 ， 由 于 token 拦截 器 一 般 与 Struts 2 标签 
<s:token/> 同 时 存在 ， 所 以 共同 完成 了 刷新 页 面 不 提交 表单 的 功能 ， 这 就 是 Struts 2 内 置 拦截 器 
token 所 起 的 作用 。 


5.5 ”使 用 拦截 器 完成 权限 控制 


前 面 在 讲 自 定义 拦截 器 的 时 候 ， 说 到 了 “ 门 ”， 并 且 也 举 了 例子 : 为 程序 做 扇 “ 门 ”。 但 
是 前 面 的 着 重点 在 于 讲解 自 定义 拦截 器 ， 这 次 将 用 一 节 的 内 容 来 讲解 如 何 为 程序 做 扇 “ 门 ”? 
如 何 判 断 用 户 是 否 有 足够 的 权限 来 执行 程序 中 的 某 些 操作 ? 这 也 是 考虑 到 在 实际 开发 中 经 常 
要 用 的 缘故 ， 希 望 读 者 能 仔细 阅读 这 一 节 内 容 ， 相 信 你 会 发 现 很 多 奥妙 的 ! 


FP 
于 视频 教学 : 光盘 /videos/05/TextInterceptor.avi 全 长 度 : 8 分 钟 


5.5.1 基础 知识 一 一 实现 权限 控制 拦截 器 


大 部 分 Web 应 用 都 涉及 权限 控制 ， 当 浏览 者 需要 请 求 执行 某 个 操作 时 ， 应 用 需要 先 检查 
浏览 者 是 否 登 录 ， 以 及 是 否 有 足够 的 权限 来 执行 该 操作 。 

本 实例 应 用 要 求 用 户 登 录 ， 且 必须 为 指定 用 户 名 才 可 以 查看 系统 中 某 个 视图 资源 ;否则 ， 
系统 直接 转 入 登录 页 面 。 对 于 上 面 的 请 求 ， 可 以 在 每 个 Action 的 执行 实际 处 理 逻 辑 之 前 ， 先 执 
行 权限 检查 逻辑 , 但 这 种 做 法 不 利于 代码 复 用 。 因 为 大 部 分 Action 里 的 权限 检查 代码 都 大 同 小 
异 ， 故 将 这 些 权限 检查 的 逻辑 放 在 拦截 器 中 进行 检查 将 会 更 加 优雅 动人 。 

检查 用 户 是 否 登 录 ， 通常 都 是 通过 跟踪 用 户 的 Session 来 实现 ， 通 过 ActionContext 即 可 访 
问 到 Session 中 的 属性 。 

// 获 取 请 求 相关 的 Actioncontext 实例 

ActionContext context=invocation.getInvocationContext(); 


// 获 取 session 


Map session = context.getSession(); 


< 人 
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读者 有 没有 觉得 很 眼熟 啊 ? 前 面 我 们 曾经 获取 过 Session， 和 这 里 的 略 有 不 同 。 拦 截 器 的 
intercept(ActionInvocation invocation) 方 法 中 的 invocation 参数 可 以 很 轻易 地 访问 到 请 求 相 关 的 
ActionContext 实例 。 

这 里 要 强调 一 点 ， 也 是 前 面 从 来 没有 提 到 过 的 。 在 拦截 器 的 intercept(ActionInvocation 
invocation) 方 法 中 ， 可 以 在 用 户 没有 登录 时 直接 返回 login 的 逻辑 视图 ， 代 码 如 下 所 示 。 


return Action.LOGIN; 


- 旦 实现 了 一 个 完美 的 权限 检查 拦截 器 ,就 可 以 在 所 有 需要 实现 权限 控制 的 Action 中 复 用 
已 经 定义 好 的 拦截 器 。 
考虑 到 这 个 拦截 器 的 重复 使 用 ,可 能 多 个 Action 都 需要 跳 转 到 login 逻辑 视图 ， 故 将 login 
Result 定义 成 一 个 全 局 Result。 下 面 是 配置 login Result 的 配置 片段 。 
<!-- 定义 全 局 Result --> 
<global-results> 
<!-- 当 返 回 1ogin 视图 名 时 ， 转 入 /login.jsp 页 面 --> 
<result name="login">/login.jsp</result> 
</global-results> 


人 》 经 过 上 面 的 配置 ， 当 用 户 没有 登录 直接 访问 系统 中 的 页 面 时 ， 将 转 入 loginjsp 
技巧 | 页面。 


这 种 通过 拦截 器 进行 权限 控制 的 方式 ， 显 然 具 有 更 好 的 代码 复 用 性 。 

如 果 为 了 简化 struts.xml 文件 的 配置 ， 避 免 在 每 个 Action 中 重复 配置 该 拦截 器 ， 可 以 将 该 
拦截 器 配置 成 一 个 默认 拦截 器 栈 (这 个 默认 拦截 器 栈 应 该 包括 default-stack 拦 截 器 栈 和 权限 检查 
拦截 器 )。 

定义 自己 默认 的 拦截 器 栈 的 配置 如 下 。 

<interceptors> 

<!-- 定义 权限 检查 拦截 器 --> 
<interceptor name=" 权 限 检 查 拦 截 器 名 ”class=" 权 限 检 查 拦截 器 类 "/> 
<!-- 定义 一 个 包含 权限 检查 的 拦截 器 栈 --> 
<interceptor-stack name=" 自 己 默认 的 拦截 器 栈 名 mydefault"> 
<!-- 定义 拦截 器 栈 包含 default-stack 拦截 器 栈 --> 
<interceptor-ref name="default-stack"/> 
<!-- 定义 拦截 器 栈 包含 权限 检查 拦截 器 --> 
<interceptor-ref name=" 权 限 检查 拦截 器 名 "/> 
</interceptor-stack> 
</interceptors> 


- 旦 定义 了 上 面 的 mydefault 拦截 器 栈 ， 这 个 拦截 器 栈 就 包含 了 权限 检查 拦截 器 和 系统 默 
认 的 拦截 器 栈 。 如 果 将 这 个 拦截 器 栈 定义 成 默认 拦截 器 , 则 可 以 避免 在 每 个 Action 中 重复 定义 
权限 检查 拦截 器 。 下 面 是 定义 默认 拦截 器 的 配置 片段 。 


<default-interceptor-ref name="mydefault"/> 


mt) >> 
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- 旦 在 某 个 包 下 定义 了 上 面 的 默认 拦截 器 栈 , 在 该 包 下 的 所 有 Action 都 会 自动 增加 权限 检 
查 功能 。 对 于 那些 不 需要 使 用 权限 控制 的 Action， 将 它们 定义 在 另外 的 包 中 一 一 这 个 包 中 依然 
使 用 系统 原来 的 默认 拦截 器 栈 ， 将 不 会 有 权限 控制 功能 。 


5.5.2 ”实例 描述 


前 几 天 听 朋 友 说 了 一 个 可 恶 至 极 的 事情 ， 现 在 想起 来 都 觉得 那 人 太 可 怕 了 。 

事情 是 这 样 的 ， 他 们 公司 有 一 个 员工 性 格 比较 内 向 ， 不 太 爱 说 话 ， 他 们 老板 更 是 看 见 他 就 
烦 ， 几 乎 是 五 天 一 大 吵 ， 三 天 一 小 吵 。 本 来 我 听 到 这 还 挺 同 情 这 人 的 ， 内 向 又 不 是 错 ， 现 在 这 
社会 内 向 虽然 不 吃香 ， 不 如 能 说 会 道 的 好 ， 但 是 内 向 不 是 人 家 的 错 ， 只 要 人 家 工作 踏实 、 勤 奋 
就 好 ……， 可 是 下 面 可 恨 的 事情 来 了 ， 结 果 老 板 在 人 家 到 公司 后 的 第 五 个 月 把 他 给 开除 了 ， 也 
许 ， 那 个 内 向 的 员工 一 肚子 的 火 没 地 方 撤 吧 ! 在 他 收拾 东西 的 过 程 中 ， 他 竞 然 登录 了 公司 内 部 
的 管理 系统 ， 把 东西 给 删 了 个 精光 。 我 的 妈 啊 ! 我 真 不 知 该 说 是 这 个 公司 老板 的 错 ， 还 是 这 个 
内 向 员工 的 错 ， 你 们 评 评 理 ， 这 是 谁 的 错 …… 


5.5.3 ”实例 应 用 


【 例 5-5】 让 非 超级 管理 员 无 权限 。 
(1) 修改 LoginAction.java 类 ， 判 断 用 户 输入 的 用 户 名 是 否 是 admin， 如 果 是 把 用 户 信息 
保存 至 Session 中 ， 否 则 返回 登录 页 面 。 修 改 后 的 内 容 如 下 。 


package com.struts2.actions; 


import java.util.Map; 
import com.opensymphony .xwork2.ActionContext; 
import com.opensymphony .xwork2.ActionSupport; 
import com.struts2.model.User; 
public class LoginAction extends ActionSsupport { 
private static final long serialVersionUID = -4278369739741451645L; 
private User user; 
public User getUser() { 
return user; 
} 
public void setUser (User user) { 
this.user = user; 
} 
@Override 
public String execute() throws Exception { 
// 获 取 相关 的 ActionCcontext 
ActionContext context=ActionContext.getContext () 7 
// 获 取 session 
Map session=context.getSession(); 
// 判 断 用 户 输入 的 用 户 名 是 否 是 adamin， 如 果 是 ， 存 入 session 中 ， 否则 返回 登录 页 面 ， 
重新 输入 


< 
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if(user!=nullgé&user.getUsername() .equals ("admin") ) 1{ 
session.put ("user", user); 

} 

else { 
return "input"7 

} 


return "main™; 


(2) 去 掉 struts-config 文件 夹 下 loginxml 文件 中 配置 的 LoginAction 类 的 拦截 器 
SimpleInterceptor， 修 改 为 : 


<action name ="login" class ="com.struts2.actions.LoginAction" > 
<result name="main">/main.jsp</result> 
<result name="input">/login.jsp</result> 

</action> 


登录 时 ， 并 不 用 拦截 器 ， 只 需要 在 LoginAction 类 中 对 用 户 输入 信息 作 个 简单 的 验证 即 可 。 
(3) 修改 拦截 UserAction 的 拦截 器 类 SimpleInterceptorjava， 判 断 用 户 输入 的 是 否 是 超级 
管理 员 信 息 ， 如 果 不 是 返回 无 权限 页 面 。 修 改 后 的 SimpleInterceptor.java 为 : 


package com.struts2.interceptor; 
import java.util.Map; 
import com.opensymphony .xwork2.Action; 
import com.opensymphony.xwork2.ActionContext; 
import com.opensymphony .xwork2.ActionInvocation; 
import com.opensymphony .xwork2.interceptor.AbstractIinterceptor; 
import com.struts2.model.User; 
public class SimpleInterceptor extends AbstractInterceptor { 
// 定 义 拦截 器 名 称 
private String name; 
public void setName (String name) 
{ 
this.name = name; 
} 
public String intercept (ActionInvocation invocation)throws Exception 
{ 
// 取 得 请 求 相关 的 Actioncontext 实例 
ActionContext context=invocation.getInvocationContext () 7 
Map session=context.getSession(); 
// 取 出 名 为 user 的 session 属性 
User user=(User) session.get ("user"); 
// 如 果 没 有 登录 ， 或 者 登录 所 用 的 用 户 名 或 者 密码 不 是 admin， 都 返回 重新 登录 
if(user!=null&é&user.getUsername() .equals ("admin") &g&user.getPass () . 
equals ("admin")) 
{ 
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return invocation.invoke(); 


1 
// 没 有 登录 ， 将 服务 器 提示 设置 成 一 个 HttpservletRequest 属性 
// 直 接 返 回 error 的 逻辑 视图 


return Action.ERROR; 


. 
(4) 修改 struts-config 文件 夹 下 的 userxml 文件 ， 为 UserAction 类 配置 拦截 器 
SimpleInterceptorjava， 修 改 后 为 : 


<?Xml Version="1.0"” encoding="UTF-8" ?> 


<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 


"http://struts.apache.org/dtds/struts-2.0.dtd"> 


<struts> 
<package name ="user" extends ="struts-default" > 


<interceptors> 
<!-- 权限 控制 拦截 器 --> 
<interceptor name="authority" 
class="com.struts2.interceptor.SimpleInterceptor"/> 
</interceptors> 
<!-- 定义 全 局 Result --> 
<global-results> 
<!-- 当 返 回 error 视图 名 时 ， 转 入 /error.jsp 页 面 --> 
<result name="error">/error.jsp</result> 


</global-results> 
<action name ="user" class ="com.struts2.actions.UserAction" > 


<result name="user">/user.jsp</result> 
<result name="add user">/add input.jsp</result> 


<!-- 定义 权限 控制 拦截 器 --> 
<interceptor-ref name="defaultstack"/> 
<interceptor-ref name="authority"/> 
</action > 
</package > 
</struts> 


(5) 再 把 登录 页 面 login.jsp 页 面 中 的 用 户 名 输入 框 的 name 属性 值 由 原来 的 username 改 成 
user.usermmame; 密码 输入 框 的 name 属性 值 由 pass 改 为 userpass。 
(6) 新 建 errorjsp 页 面 ， 提 示 “ 无 权限 ” 即 可 。 


5.5.4 运行 结果 


运行 程序 ， 在 登录 页 面 中 输入 用 户 名 : admin， 口 令 : 123456789。 单 击 “ 登 录 ” 按 钮 ， 进 
入 主页 面 ， 单 击 左边 导航 中 的 “管理 员 列 表 ”， 出 现 提示 无 权限 信息 页 面 ， 如 图 5-11 所 示 。 
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报 作 有 误 ， 您 没有 权限 … 


图 5-11 非 超级 管理 员 权限 
返回 登录 页 面 ， 输 入 用 户 名 : admin， 口 令 : admin。 登 录 之 后 再 次 单 击 左边 导航 中 的 “ 管 
理 员 列表 ”显示 所 有 管理 员 信 息 ， 如 图 5-12 所 示 。 
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图 5-12 ”超级 管理 员 权限 


5.5.5 ”实例 分 析 


ee 


上 述 案例 中 ， 在 LoginAction 类 中 并 未 定义 拦截 器 ， 而 是 在 它 的 execute() 方 法 中 对 用 户 输 
入 信息 进行 了 一 下 简单 验证 : 只 要 用 户 名 为 admin 的 就 可 以 登录 本 系统 。 但 是 登录 到 本 系统 的 
未 必 能 对 本 系统 的 所 有 操作 都 有 权限 ， 因 此 需要 为 UserAction 类 定义 一 个 拦截 器 
SimpleInterceptor， 验 证 只 有 是 超级 管理 员 才 有 查看 管理 员 列 表 的 权限 。 

这 个 功能 在 实际 开发 中 应 用 很 多 ， 不 同 的 用 户 身份 登录 系统 后 权限 是 不 一 样 的 。 


mi >> 
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5.6 ”使 用 拦截 器 注解 


如 果 您 是 一 个 开发 者 的 话 ， 一 定 深 知 “注解 ”为 您 带 来 的 惊喜 吧 ! 在 Hibermate 中 ， 可 以 
利用 注解 来 进行 映射 ;在 Spring 中 ， 可 以 利用 注解 来 实现 AOP; 今天 ， 同 样 可 以 利用 拦截 器 
注解 来 指定 在 Struts 2 中 的 Action 执行 之 前 和 之 后 需要 调用 的 方法 。 

下 面 这 一 节 就 来 为 读者 讲解 一 下 如 何 使 用 拦截 器 注解 。 


Ey 3 区 
匡 w 视频 教学 : 光盘 /videos/05/annotations.avi 全 长 度 : 7 分 钟 


5.6.1 基础 知识 


使 用 拦截 器 注解 

Struts 2 在 com.opensymphony.xwork2.interceptor.annotations 包 中 定义 了 3 个 拦截 器 注解 类 
型 , 读者 可 以 不 用 编写 拦截 器 类 , 直接 通过 注解 的 方式 来 指定 在 Action 执行 之 前 和 之 后 需要 调 
用 的 方法 。 

Stmts 2 提供 的 3 个 拦截 器 注解 类 型 都 只 能 应 用 到 方法 级 别 ， 如 下 所 示 。 

1. Before 

Before 用 于 标注 一 个 Action 方法 , 该 方法 将 在 Action 的 主要 方法 (如 execute0 方 法 ) 调 用 之 
前 调用 。 如 果 标 注 的 方法 有 返回 值 , 并 且 不 为 null, 那么 它 的 返回 值 将 作为 Action 的 结果 代码 。 

2. After 

After 用 于 标注 一 个 Action 方法 ， 该 方法 将 会 在 Action 的 主要 方法 以 及 result 执行 之 后 调 
用 。 如 果 标 注 的 方法 有 返回 值 ， 那 么 这 个 返回 值 将 会 被 忽略 。 


3. BeforeResult 
BeforeResult 用 于 标注 一 个 Action 方法 , 该 方法 将 在 Action 的 主要 方法 调用 之 后 , 在 result 
执行 之 前 调用 。 如 果 标 注 的 方法 有 返回 值 ， 那 么 这 个 返回 值 将 被 忽略 。 
这 3 个 注解 类 型 都 有 一 个 同名 的 参数 ， 该 参数 的 作用 也 是 相同 的 ， 如 表 5-2 所 示 。 
表 5-2 ”Before、After 和 BeforeResult 注 解 的 同名 参数 


[nm Is ll | 


指定 方法 执行 的 优先 级 顺序 

同一 个 注解 可 以 用 来 标注 多 个 方法 ， 方 法 执行 的 先后 顺序 可 以 通过 priority 参数 来 指定 ， 
优先 级 越 高 ， 方 法 越 优先 执行 。 在 相同 优先 级 的 情况 下 ， 方 法 执行 的 顺序 将 无 法 保证 。 不 过 ， 
对 于 有 继承 关系 的 Action 类 ， 在 基 类 上 标注 的 方法 将 优先 于 在 派生 类 上 标注 的 方法 执行 。 


@ ”Before 和 After 注解 用 于 替代 拦截 器 实现 ，BeforeResult 注解 用 于 替代 PreResult 
| Listener 实现 。 


< 
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要 使 用 拦截 器 注解 ， 还 需要 配置 AnnotationWorkflowInterceptor 拦截 器 。 这 个 拦截 器 在 
struts-default.xml 文件 中 并 未 定义 ， 因 此 需要 用 户 自己 在 struts.xml 文件 中 定义 ， 代 码 如 下 。 


<interceptors> 
<!-- 配置 AnnotationWorkflowInterceptor 拦截 器 一 一 > 
<interceptor name="annotationInterceptor" 
class="com.opensymphony .xwork2.interceptor.annotations. 
AnnotationWorkflowInterceptor"/> 
<interceptor-stack name="annotatedstack"> 
<interceptor-ref name="defaultstack"/> 
<interceptor-ref name="annotationInterceptor"/> 
</interceptor-stack> 
</interceptors> 


采用 上 面 的 配置 后 ， 在 Action 中 就 可 以 直接 引用 annotatedStack 拦截 器 栈 了 。 
5.6.2 ”实例 描述 


上 次 公司 技术 部 在 开会 的 时 候 ， 提 到 拦截 器 的 使 用 方式 ， 一 部 分 人 说 : 采用 自 定义 拦截 器 
好 ， 在 Struts 2 配置 文件 中 配置 一 下 就 可 以 了 ， 很 方便 ， 另 一 部 分 人 说 : 采用 拦截 器 注解 方式 
好 ， 连 编辑 自 定义 拦截 器 类 都 不 用 ,在 Action 中 的 方法 中 编辑 验证 即 可 ,查看 代码 那 是 方便 又 
快捷 啊 ! 只 要 打开 Action 就 知道 这 个 Action 想 要 验证 哪些 信息 ， 而 不 像 配 置 拦截 器 那样 ， 还 
得 先 看 看 配置 文件 才 知 道 这 个 Action 用 了 哪个 拦截 器 。 

那个 说 使 用 拦截 器 注解 的 同事 很 快 就 给 我 们 做 了 一 个 例子 ， 让 我 们 心服 口服 啊 ! 


5.6.3 ”实例 应 用 


【 例 5-6】 使 用 拦截 器 注解 进一步 完善 那 道 “ 门 ”。 
(1) 修改 LoginActionjava 类 ， 使 用 拦截 器 注解 形式 来 验证 用 户 信息 ， 如 果 用 户 输入 正确 
则 保存 至 Session 中 ， 否 则 重新 登录 。 修 改 代码 如 下 所 示 。 


package com.struts2.actions; 
import java.util.Map; 
import com.opensymphony.xwork2.ActionContext; 
import com.opensymphony .xwork2.ActionSupport; 
import com.opensymphony .xwork2.interceptor.annotations.Before; 
import com.struts2.model.User; 
public class LoginAction extends RctionSupport { 
private static final long serialVersionUID = -4278369739741451645L; 
private. User Users 
public User getUser() { 
return user; 
} 
public void setUser (User user) { 
this.user = user; 
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} 
@Before 
public String checkUser (){ 
// 获 取 相 关 的 ActionCcontext 
ActionContext context=ActionContext.getContext () 7 
// 获 取 Ssession 
Map session=context.getSession(); 
// 判 断 用 户 输入 的 用 户 名 是 否 是 admin， 如 果 是 ， 存 入 session 中 ， 否 则 返回 登录 页 面 ， 
重新 输入 
if(user!=null&&user-getUsername () .equals ("admin")&&user.getPass () .equals 
("agdmin")){ 
session.put ("user", user); 
return null; 
CLSe 
return INPUT; 


} 
QOverride 
public String execute() throws Exception { 
// 获 取 相 关 的 actionContext 
ActionContext context=ActionContext.getContext () 7 
// 获 取 session 
Map session=context.getSession(); 
// 检 查 用 户 是 否 登 录 
User loginUser=(User)session.get ("user"); 
if(loginUser!=null1){ 
return "main"7 
. 
else { 
return INPUT; 


(2) 在 login.xml 文件 中 配置 AnnotationWorkflowInterceptor 拦截 器 ， 并 在 LoginAction 中 
该 拦截 器 ， 配 置 代码 如 下 。 


<package name ="login" extends ="struts-default" > 
<interceptors> 


< 


<interceptor name="annotationInterceptor" 
class="com.opensymphony .xwork2.interceptor.annotations. 
AnnotationWorkflowInterceptor"/> 

<interceptor-stack name="annotatedstack"> 
"defaultstack"/> 
<interceptor-ref name="annotationInterceptor" /> 


<interceptor-ref nam 


</interceptor-stack> 

</interceptors> 

<action name ="login" class ="com.struts2.actions.LoginAction" > 
<result name="main">/main.jsp</result> 
<result name="input">/login.jsp</result> 


< 
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<!- 引 用 annotationWorkflowInterceptor 拦截 器 配置 --> 
<interceptor-ref name="annotatedstack"/> 
</action > 


</package > 


(3) 修改 UserActionjava 类 ， 在 执行 execute0 方 法 之 前 ， 先 判断 用 户 是 否 登录 ， 如 果 没 有 


登录 , 则 返回 无 权限 页 面 , 这 样 是 为 了 防止 浏览 者 直接 请 求 Action 方法 而 导致 的 一 些 不 必要 的 
麻烦 ， 修 改 后 的 内 容 如 下 所 示 。 


package com.struts2.actions; 

import java.util.ArrayList; 

import java.util.List; 

import java.util.Map; 

import com.opensymphony.xwork2.ActionContext; 

import com.opensymphony.xwork2.ActionSupport; 

import com.opensymphony .xwork2.interceptor.annotations.Before; 
import com.struts2.model .User; 

public class UserAction extends ActionSupport { 


List<User> userList=new ArrayList<User>(); 
private User user; 
public User getUser() { 
return user; 
} 
public void setUser (User user) 1{ 
this.user = user; 
} 
@Before 
public String checkUser(){ 
// 获 取 相 关 的 ActionContext 
ActionContext context=ActionContext.getContext (); 
// 获 取 session 
Map session=context.getSession(); 
User loginUser=(User)session.get ("user"); 
if(loginUser!=null){ 
return null; 
} 
else { 
TeEUrn "error™> 


} 

@Override 

public String execute() throws Exception { 
/* 内 容 省 略 */ 

上 

/* 打 开 添加 用 户 信息 方法 省 略 */ 

/* 添 加 用 户 信息 方法 省 略 */ 

/* 删 除 用 户 信息 方法 省 略 */ 
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(4) 接着 在 UserAction 中 配置 AnnotationWorkflowInterceptor 拦截 器 ， 和 上 面 在 
LoginAction 中 配置 一 样 ， 先 在 package 的 名 称 中 为 user 定义 拦截 器 栈 annotatedStack， 然 后 在 
UserAction 中 引用 就 可 以 了 ， 同 时 去 掉 权 限 控制 拦截 器 的 配置 。 


5.6.4 运行 结果 


运行 loginjsp 页 面 ， 输 入 用 户 名 和 口令 ， 如 果 输 入 的 用 户 名 或 口令 不 是 admin， 则 无 法 进 
入 主页 面 main.jsp。 

直接 访问 login/login.action， 看 看 出 现 什么 结果 ?对 ， 还 是 返回 login.jsp 页 面 。 

接着 直接 访问 user/user.action， 看 看 出 现 什么 结果 ? 结果 如 图 5-13 所 示 。 
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5-13 直接 访问 Action 


5.6.5 ”实例 分 析 


ne 


上 述 和 案例 中 , 使 用 拦截 器 注解 形式 为 Action 做 了 拦截 , 验证 用 户 是 否 已 经 登录 并 且 是 合法 
用 户 。 在 执行 LoginAction 中 的 主 方法 execute() 之 前 会 调用 checkUser() 方 法 ， 所 以 如 果 直 接 访 
问 login/login.action 时 ，LoginUser 中 的 User 对 象 是 空 的 ， 无 法 把 用 户 输入 信息 保存 至 Session 
中 ， 故 返回 “JINPUT” 结果 页 面 ， 对 应 的 就 是 login.jsp 页 面 。 

在 UserAction 中 新 添加 方法 checkUser()， 并 使 用 “(@Before” 对 该 方法 作 了 注解 ， 程 序 在 
执行 UserAction 中 的 execute() 方 法 之 前 会 执行 checkUser() 方 法 ; 如 果 用 户 未 登录 ，Session 中 
的 “user” 是 null， 故 返回 “error” 结 果 页 面 ， 对 应 的 就 是 error.jsp 页 面 ， 即 提示 无 权限 页 面 。 
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5.7.1 Struts 2 自 带 的 拦截 器 已 经 很 强大 , 是 否 可 以 不 用 自 定 义 拦截 器 


Struts 2 自 带 的 拦截 器 不 是 已 经 很 强大 了 吗 ? 是 不 是 就 不 用 自 定 义 拦截 器 了 ? 
网 络 课堂 : http://bbs.itzen.comy/thread-11003-1-1.html 


问 : 不 是 说 Struts 2 自 带 的 拦截 器 已 经 很 强大 了 吗 ? 那 为 什么 还 要 用 自 定 义 的 拦截 器 呢 ? 
只 用 Struts 2 自 带 的 拦截 器 是 不 是 在 开发 中 已 经 够 用 了 啊 ? 如 果 想 写 一 个 检查 用 户 是 否 登录 的 
拦截 器 该 如 何 下 手 呢 ? 

答 : 首先 我 要 回答 你 的 是 一 个 字 ， 对 ， 是 需要 我 们 自 定义 拦截 器 去 实现 。 

编辑 一 个 检查 用 户 是 否 登录 的 拦截 器 是 开发 中 最 常用 的 拦截 器 之 一 ， 思 路 如 下 。 

(1) 将 用 户 名 、 密 码 等 信息 记录 在 Session 中 。 

(2) 编写 自 定义 拦截 器 ， 取 出 Session 进行 判断 ， 看 是 否 存 在 该 用 户 信 息 。 

(3) 将 拦截 器 配置 到 struts.xml 相应 的 Action 中 。 

自 定义 拦截 器 的 方法 要 继承 AbstractInterceptor， 实 现 抽 象 方法 。 


public abstract String intercept (ActionInvocation invocation) throws Exception 


具体 的 例子 我 在 这 章 已 经 做 了 重点 讲解 了 , 仔细 阅读 本 章 内 容 你 将 会 明白 拦截 器 的 具体 配 
置 和 使 用 。 


5.7.2 Struts 2 拦截 器 的 错误 信息 如 何 显示 在 页 面 上 


侦 员 Struts 2 拦截 器 的 错误 信息 如 何 显示 在 页 面 上 ? 


[a 外 网 络 课堂 : http://bbs.itzcn.comy/thread-11005-1-1.html 


问 : 我 在 拦截 器 类 中 把 错误 信息 放 入 一 个 容器 中 ,但 是 我 怎么 在 页 面 上 显示 呢 ? 比如 下 面 
这 段 代 码 里 的 “ctx.put(“tip”,“ 您 还 没有 登录 ， 请 重新 登录 ”);”， 我 怎么 能 在 页 面 上 显示 呢 ? 
public class AuthorityInterceptorForAdmin extends AbstractInterceptor { 
private static final long serialVersionUID = 1358600090729208361L7 
// 拦截 Action 处 理 的 拦截 方法 
public String intercept (ActionInvocation invocation) throws Exception { 
// 取得 请 求 相关 的 Actioncontext 实例 
ActionContext ctx = invocation.getInvocationContext () 7 


Map session = ctx.getSession(); 
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// 取出 名 为 user 的 session 属性 
String user = (String) session.get ("aid"); 
List<Admin> adminlist = new Base() .getAdmin() .getAdminAll (); 
Iterator it = adminlist.iterator(); 
while (it.hasNext()) { 

Admin admin = (Admin) it.next(); 

String ad = admin.getName (); 

if (user != null && User-equals (ad)) { 

return invocation.invoke(); 


} 


} 
// 没有 登录 ， 将 服务 器 提示 设置 成 一 个 HttpservletRequest 属性 
ctx.put ("tip"，" 您 还 没有 登录 ， 请 登陆 系统 ") ; 


return Action.LOGIN; 


答 : 首先 ， 你 的 拦截 器 应 该 有 一 个 返回 页 面 ， 也 就 是 说 触发 拦截 时 要 返回 到 的 页 面 (比方 
说 登录 页 面 )。 这 个 页 面 你 可 以 自己 在 配置 文件 里 定义 ， 用 过 Struts 2 的 校 验 功能 ， 就 应 该 知道 
如 何在 页 面 显示 提示 信息 了 。( 针 对 Struts 2 的 重 写 方法 校 验 ， 不 是 XML 校 验 框架 )。 简 单 来 说 
就 是 : 用 Action 中 的 addFieldError0 方 法 。 

JSP 页 面 上 用 下 列 代码 即 可 显示 。 


<s:fielderror></s:fielderror> 


当然 ， 显 示 提 示 信 息 可 以 灵活 运用 ， 你 完全 可 以 把 信息 设置 在 自 定义 的 控件 上 。 
5.7.3 ”Struts 2 拦截 器 后 跳 转 页 面 问题 


Struts 2 拦截 器 后 跳 转 页 面 问题 ! 
网 络 课堂 : http:/Wbbs.itzcn.comny/thread-11006-1-1.html 


问 : 我 用 了 自 编 的 拦截 器 , 如 果 输 入 错误 的 Action 就 返回 Action.LOGIN, 在 struts.xml 中 ， 
设置 flash 不 能 显示 。 但 是 我 把 <result name=“login”>/index.jsp</result> 改 成 <result name= “login” 
type=“redirect”>/index</result>， 结 果 就 没事 了 。 这 里 怎么 回 事 ? 

答 : 因为 跳 转 时 服务 器 端 跳 转 ， 地 址 栏 没 改变 ， 所 以 会 造成 路 径 错 误 ， 建 议 你 将 图 片 等 路 
径 改 为 以 下 形式 。 


<img src="#request.path"/images/xxx.gif/> 


其 中 /images/xxx.gif 为 你 的 图 片 在 WebRoot 下 的 路 径 和 文件 名 。 


< 
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5.7.4 Struts 2 拦截 器 通俗 点 到 底 是 什么 ? 为 什么 要 用 


[@l 自学 中 ，Struts 2 拦截 器 通俗 点 到 底 是 什么 东 东 啊 ? 为 什么 要 用 ? 


CDR。 网 络 课堂 : http://bbs.itzcn.com/thread-11011-1-1.html 


问 : 最 近 自 学 中 ， 用 是 全 会 了 ,但 是 我 具体 还 是 不 怎么 理解 。 为 什么 要 用 ? 有 什么 好 处 ? 
什么 时 候 用 最 恰当 ? 亦 或 者 就 拿 登 录 页 面 打 个 比方 。 

答 : 拦截 器 相当 于 过 滤器 ， 就 是 把 你 不 想 要 的 或 不 想 显示 的 内 容 给 过 滤器 。 拦 截 器 可 以 抽 
象 出 一 部 分 代码 ， 用 来 完善 原来 的 Action， 同 时 可 以 减轻 代码 元 余 ， 提 高 重用 率 。 

例如 在 登入 一 个 页 面 时 ， 如 果 要 求 用 户 密码 、 权 限 等 的 验证 ， 就 可 以 用 自 定 义 的 拦截 器 进 
行 密码 验证 和 权限 限制 。 对 符合 的 登入 者 才 跳 转 到 正确 页 面 。 这 样 如 果 有 新 增 权 限 的 话 ， 不 用 
在 Action 里 修改 任何 代码 ， 直 接 在 Interceptor 里 修改 就 行 了 。 


5.8 习 题 


一 、 填 空 题 

(1) 定义 拦截 器 最 简单 的 格式 为 : 

<interceptor name=" "class=" 拦 截 器 类 "/> 

(2) 如 果 一 个 action 需要 多 个 拦截 器 ， 在 action 中 的 配置 为 <interceptor-ref 
name="loginAndSecurityStack"/>， 则 在 <interceptors> 元 素 内 的 配置 为 。 


<interceptors> 
<interceptor name="logger" 
class="com.struts2.interceptor.LoginInterceptor"/> 
<interceptor name="security" 


class="com.struts2.interceptor.SecurityInterceptor"/> 


</interceptors> 


(3) 如 果 用 户 要 开发 自己 的 拦截 器 类 ， 应 该 实现 com.opensymphony.xwork2.interceptor. 


Interceptor 接口 ， 该 接口 中 的 方法 是 用 户 需要 实现 的 拦截 动作 。 
(4) 我 们 在 实现 方法 过 滤 拦 截 器 时 需要 编辑 一 个 继承 MethodFilterInterceptor.java 的 类 , 同 


(5) Struts 2 提供 的 3 个 拦截 器 注解 类 型 中 ， 它 们 都 有 一 个 同名 的 参数 ， 该 参数 的 名 字 是 
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二 、 选 择 题 
(1) 我 们 在 定义 一 个 拦截 器 时 可 以 为 该 拦截 器 指定 参数 及 参数 值 ， 用 <param></param> 标 
签 来 指定 ， 那 么 我 们 最 多 可 以 为 一 个 拦截 器 指定 多 少 个 参数 呢 ? 
过 Bs 3 本 
人 5 D. 多 个 
(2) 如 果 想 实现 方法 过 滤 拦 截 器 ， 则 拦截 器 类 需要 继承 MethodFilterInterceptor 类 ， 在 
MethodFilterInterceptor 类 中 有 两 个 方法 用 来 指定 哪个 方法 需要 拦截 ， 哪 个 不 需要 。 那么 过 滤 方 
法 的 拦截 是 方法 。 


A. setExcludeMethods B. setIncludeMethods 
C. dolIntercept D. 以 上 方法 都 不 是 
(3) 配置 默认 拦截 器 使 用 元 素 ， 该 元 素 作 为 <package .../> 元 素 的 子 元 素 使 用 ， 


为 该 包 下 的 所 有 Action 配置 默认 的 拦截 器 。 
A. <default-interceptor-ref /> 
B. <interceptor-ref /> 
C. <interceptor-default-ref ../> 


D. <default-interceptor /> 
(4) 下 面 是 配置 默认 拦截 器 的 配置 示例 。 


<package name=" 包 名 "> 
<!-- 所 有 拦截 器 和 拦截 器 栈 都 配置 在 该 元 素 下 --> 
<interceptors> 
<!-- 定义 拦截 器 --> 
<interceptor name=" 拦 截 器 名 ”class=" 拦 截 器 类 "/> 
(1) 
</interceptors> 
(2) 
<!-- 配置 多 个 Action --> 
<action 一 /> 


</package> 

<default-interceptor-ref name=" 拦 截 器 名 "/> 应 放 在 上 段 代码 中 的 处 。 
A，(1) 处 B. (2) 处 
C.， 都 可 以 D.， 都 不 可 以 


三 、 上 机 练习 

上 机 练习 : 为 程序 添加 权限 。 

要 求 : 做 一 个 简单 的 登录 页 面 如 图 5-14 所 示 。 对 登录 用 户 进行 验证 , 如 果 是 合法 用 户 ( 合 
法 就 是 符合 标准 ， 标 准 可 以 自己 定义 ) 可 以 进入 本 系统 的 主页 面 ， 如 图 5-15 所 示 ， 否 则 无 法 进 
入 主页 面 。 
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管理 中 心 登陆 ¥1.0 - Windows Internet Explorer 
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图 5-14 登录 界面 


V1-0 — Windows Internet Explorer 
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admin 13652847589 
lizanhong 13744784857 
Xiaona 15985648759 
zhangdongwu 13658476585 


5-15 主页 面 


进入 主页 面 后 ， 每 个 人 都 有 查看 管理 员 列 表 的 权限 ， 但 非 超级 管理 员 无 添加 、 删 除 管理 员 
的 权限 ， 单 击 “ 添 加 管理 员 ” 链 接 或 者 “删除 ”链接 ， 转 到 提示 无 权限 页 面 ， 如 图 5-16 所 示 。 
只 有 超级 管理 员 登 录 才 有 添加 、 删 除 管理 员 的 权限 ， 如 图 5-17 所 示 。 


Read >> 


怎 理 中 心 V1.0 一 Windowz Internet FEzplorer 
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站 管理 中 心 当 关 用 户 : admin 此 避 S， 退 由 和 


nt: 2010-10-12 16:14:55 


操作 有 误 : 您 没有 权限 .… 


【返回 管理 员 列 条 】 


当前 用 户 : admln 能 改 口 售 ”退出 系统 


图 5-17 ”超级 管理 员 添 加 管理 员 操 作 
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内 容 摘 要 : 

在 Web 应 用 程序 中 ， 为 了 防止 客户 端 传 来 的 数据 引发 程序 的 异常 ， 需 要 对 用 户 输入 的 数 
据 进行 验证 。 试 想 一 下 ， 如 果 Web 应 用 没有 对 用 户 输入 数据 进行 验证 ， 那 么 当 用 户 由 于 误 操 
作 而 输入 了 一 些 无 效 的 数据 时 ， 程序 会 向 用 户 显示 一 大 堆 的 异常 栈 信 息 ， 这 是 一 件 多 么 糟糕 的 
事情 。 更 何况 有 一 些 恶 意 的 用 户 可 以 通过 输入 精心 伪造 的 数据 来 攻击 某 个 系统 ， 破 坏 系统 的 运 
行 ， 窃 取 协 同 的 机 密 资 料 。 而 这 一 切 ， 都 是 因为 系统 没有 对 用 户 输入 的 数据 进行 验证 。 

在 Web 应 用 程序 中 构建 一 个 强 有 力 的 验证 机 制 ， 是 保障 系统 稳定 运行 的 前 提 条 件 。 对 用 
户 输入 数据 进行 验证 分 为 两 个 部 分 : 一 是 验证 输入 数据 的 有 效 性 ， 二 是 在 用 户 输入 了 不 正确 的 
数据 后 向 用 户 提示 错误 信息 。 

本 章 将 讲述 如 何在 Struts 2 中 对 用 户 输入 数据 进行 验证 。 

学 习 目 标 : 
在 Action 中 通过 编程 对 输入 数据 进行 验证 。 
掌握 validateXxx 和 validate() 方 法 的 使 用 。 
熟悉 Struts 2 内 置 的 验证 器 。 
掌握 验证 框架 在 开发 中 的 使 用 。 
熟练 开发 自 定义 的 验证 器 。 
掌握 验证 注解 的 使 用 。 
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6.1 手动 完成 输入 校 验 


-个 技术 成 熟 的 开发 者 可 能 已 经 习惯 自己 的 校 验方 法 ， 那 就 是 ， 在 Servlet 中 进行 有 效 的 
服务 器 端 校 验 。 但 这 种 校 验 很 繁琐 ， 需 要 书写 多 行 的 校 验 代 码 来 完成 一 个 表单 的 数据 校 验 。 而 
且 采 用 这 种 校 验 开 发 效率 低 ， 校 验 明显 不 够 规范 。 通 常 而 言 ， 每 个 MVC 框架 都 会 提供 规范 的 
数据 校 验 部 分 ，Struts 2 也 不 例外 。 下 面 介绍 通过 手动 方式 在 Struts 2 中 完成 输入 校 验 。 


1 s y 入 A 
甘 w 视频 教学 光盘 /videos/06/validate.avi 生长 度 : 9 分 钟 
光盘 /videos/06/validateXxx.avi 国度 : 7 分 钟 


6.1.1 基础 知识 一 一 手动 完成 输入 校 验 


最 直接 的 验证 方式 ， 就 是 编写 Java 代码 对 用 户 提交 的 数据 进行 验证 。 在 Struts 2 中 ， 验 证 
代码 是 放 在 Action 类 中 完成 的 。 
1. 在 Action 的 execute() 方 法 中 进行 验证 
当 一 个 请 求 到 来 的 时 候 , 框架 调用 Action 的 execute0 方 法 对 用 户 请 求 进行 处 理 , 首先 想到 
的 就 是 在 execute0 方 法 中 对 用 户 输 入 数据 的 验证 。 

下 面 用 一 个 实例 来 说 明 问题 。 
首先 在 RegistAction 中 编辑 execute 方法 ， 并 进行 对 用 户 输入 数据 进行 验证 ， 代 码 如 下 。 
public class RegistAction extends ActionSupport { 

// 该 请 求 包含 的 4 个 请 求 参 数 

private String name; 

private String pass; 

private int age; 

private Date birth; 

// 在 Action 的 execute 方法 中 进行 验证 

public String execute() throws Exception { 

// 如 果 用 户 名 不 为 室 ， 且 不 匹配 长 度 为 4~25 的 字母 和 数字 组 成 的 字符 串 
if(name!=null&&!Pattern.matches("\\w{4,25}", name.trim())){ 
addFieldError ("username",， "您 输入 用 户 名 必须 是 字母 和 数字 ， 且 长 度 必 须 是 4 
到 25 之 间 "); 
return INPUT; 


3 

/ /如果 密 码 不 为 空 ， 且 不 匹配 长 度 为 4~25 之 间 的 字母 和 数字 组 成 的 字符 串 

if(pass!=null&&!Pattern.matches("\\w{4,25}", pass.trim())){ 
aqddFieldError ("pass", "您 输入 密码 必须 是 字母 和 数字 , 且 长 度 必 须 是 4 到 25 之 间 ") ; 


return INPUT; 


业 
// 如 果 年 龄 不 在 有 效 的 年 龄 段 内 
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if(lage>150 || age<0){ 
addFieldError ("age"，" 您 输入 的 年 龄 必须 是 一 个 有 效 的 年 龄 ") ; 


return INPUT; 


} 
// 取 得 有 效 生日 的 最 后 期 限 
Calendar end=Calendar .getInstance () 7 
end.set (2010, 10,30); 
// 取 得 有 效 生日 的 最 早期 限 
Calendar start=Calendar.getInstance(); 
start.set(1900, 1, 1); 
// 如 果 生 日 不 为 空 ， 且 生日 不 是 一 个 有 效 的 生日 
if(birth!=nullgg& (birth.after(end.getTime())||birth.before (start.getTime 


(pe 
addFielqdError ("birth",， "您 输入 的 生日 必须 在 一 个 有 效 的 时 间 段 内 ") ; 
return INPUT; 
} 
return SUCCESS; 


} 
/* 下 面 是 上 面 4 个 属性 的 set、get 方法 ， 这 里 省 略 */ 
则 
当 用 户 请 求 RegistAction 中 的 execute 方法 时 ， 会 对 输入 的 数据 进行 验证 ， 从 而 判断 要 返 
回 给 客户 端的 结果 页 面 应 该 是 哪个 ? “INPUT” 指 向 的 结果 页 面 就 是 用 户 注 册页 面 regjsp， 在 
本 页 面 中 可 以 用 <s:fielderror> 标 签 输出 Action 中 的 错误 信息 ， 如 图 6-1 所 示 。 当 用 户 输入 的 数 
据 都 合法 时 ， 进 入 “SUCCESS” 指 向 的 结果 页 面 success.jsp 页 面 ， 如 图 6-2 所 示 。 


富安 加 ten et -ee ma et 


恭喜 您 ! 注册 成 功 ! 


A Stressful Time of Year - Xmas 


6-1 ”提示 错误 信息 (注册 页 面 ) 6-2 ”注册 成 功 
2. 在 validateXxx() 方 法 中 进行 验证 
有 了 上 面 所 讲 的 在 Action 中 的 execute 方法 中 进行 验证 做 铺垫 , 下面 要 讲 的 在 validateXxx() 
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方法 中 进行 验证 就 不 难 了 。 
1 》 在 execute() 方 法 中 对 输入 数据 进行 验证 是 可 以 工作 的 ， 但 是 它 向 execute() 方 法 添 
警告 加 了 很 多 代码 。 如 果 一 个 复杂 的 表单 有 很 多 字段 ， 而 且 每 个 字段 有 多 种 验证 ， 那 
么 execute() 方 法 中 的 代码 将 急剧 膨胀 ， 使 得 完成 业务 逻辑 的 代码 淹没 在 验证 代码 
之 中 ， 变 得 不 可 辨别 。 

较 上 述 在 Action 中 的 execute0 方 法 中 对 输入 数据 进行 校 验 相 比 , 比较 好 的 方式 是 把 验证 代 
码 剥 离 出 来 ， 放 在 一 个 单独 的 方法 中 ， 然 后 在 execute() 方 法 中 调用 该 方法 。 除 此 之 外 ， 也 可 以 
利用 Struts 2 提供 的 便利 特性 ， 将 验证 代码 放 到 形 如 validateXxx0 的 方法 中 。 

在 Struts 2 中 ， 对 于 多 个 不 同 的 请 求 ， 可 以 使 用 同一 个 Action 类 的 不 同方 法 来 进行 处 理 ， 
针对 特定 方法 的 输入 数据 的 验证 处 理 可 以 放 到 validateXxx0 方 法 中 ，Xxx 是 方法 名 的 首 字母 大 
写 形式 (例如 execute() 方 法 的 验证 方法 为 validateExecute())。 不 过 要 注意 的 是 ， 对 于 doXxx() 方 
法 ， 它 的 验证 方法 名 无 须 添加 do 前 级 ， 直 接 写 成 validateXxx0 即 可 (例如 doDefault0 方 法 的 验 
证 方法 为 validateDefaultO)。 

validateXxx() 方 法 由 框架 自动 调用 ， 它 将 在 实际 处 理 请 求 、 实 现 业务 轴 辑 的 方法 调用 之 前 
被 调用 。 


validateExecute() 方 法 不 需要 有 返回 值 ， 如 果 有 验证 错误 ， 直 接 将 它 添加 到 Action 
的 字段 错误 中 即 可 。validateXxx() 方 法 是 由 com.open symphony.xwork2.interceptor. 
DefaultWorkFlowInterceptor 拦截 器 (已 包含 在 defaultStack 拦截 器 栈 中 ) 调 用 的 。 


注意 


3. 在 validate() 方 法 中 进行 验证 

如 果 处 理 用 户 请 求 的 多 个 Action 方法 的 验证 逻辑 是 相同 的 ， 那 么 可 以 让 Action 类 实现 
com.opensymphony.xwork2.Validateable 接口 , 然后 在 该 接口 定义 的 validate0 方 法 中 对 用 户 输入 
数据 进行 验证 。 不 管 处 理 请 求 的 Action 方法 是 哪 一 个 ，validate0 方 法 都 会 被 调用 。 

validate() 方 法 是 由 DefaultWorkFlowInterceptor 拦截 器 调用 的 ，DefaultWorkFlowInterceptor 
会 检查 Action 是 否 实 现 了 Validateable 接口 ， 如 果实 现 了 ， 就 调用 该 接口 中 的 validate0 方 法 。 
validate() 方 法 在 validateXxx() 方 法 调用 之 后 被 调用 , 并 且 无 论 validateXxx() 方 法 执行 结果 如 何 ， 
validate() 方 法 都 会 被 调用 。 

调用 validate0 方 法 的 拦截 器 该 拦截 器 DefaultWorkFlowInterceptor 有 一 个 excludeMethods 
参数 ， 用 于 指定 要 排除 的 方法 ， 对 于 被 排除 的 方法 ，DefaultWorkFlowInterceptor 拦截 器 的 
doIntercept0 方 法 将 不 会 被 调用 ， 因 此 validate0 方 法 也 就 不 会 被 调用 了 。 

struts-default.xml 文件 中 , DefaultWorkFlowInterceptor 拦截 器 的 配置 (在 defaultStack 拦截 器 
栈 的 配置 中 ) 如 下 。 


<interceptor-ref name="workflow"> 
<param name="excludeMethods">input,back,cancel</param> 


</interceptor-ref> 


从 这 个 配置 中 读者 可 以 了 解 到 , 将 一 个 表单 的 Action 方法 命名 为 input、back、cancel 或 者 
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doInput、doBack、doCancel， 那 么 validate0) 方 法 将 不 会 执行 。 如 果 需 要 配置 拦截 器 要 排除 的 方 
法 ， 需 要 修改 struts.xml 文件 ， 如 下 所 示 。 
<interceptor-ref name="defaultstack"> 


<param name="workflow.excludeMethods">xxx</param> 
</interceptor-ref> 


在 Action 中 的 execute0 方 法 中 对 输入 数据 进行 校 验 的 代码 , 一 旦 发 现 校 验 失败 , 就 把 校 验 
失败 提示 通过 addFieldError 方法 添加 进 系 统 的 fieldError 中 , 在 这 里 的 validate0 方 法 中 也 一 样 。 
为 了 在 input 视图 对 应 的 JSP 页 面 中 输出 错误 提示 ， 应 该 在 该 页 面 中 增加 如 下 代码 。 
<!-- 校 验 失败 提示 信息 --> 
<s:fielderror/> 
上 面 的 <s:fielderror/> 标 签 专门 负责 输出 系统 的 fieldError 信息 ， 也 就 是 输出 系统 的 输入 校 
验 失败 提示 。 
》 即使 类 型 转换 失败 ， 系 统 也 不 会 直接 返回 input 逻辑 视图 ， 依 然 会 调用 Action 的 
注意 validate 方法 来 进行 输入 校 验 。 这 一 点 ， 与 前 面 介 绍 的 类 型 转换 失败 处 理 后 的 处 理 
时 一 致 的 。 


4. Struts 2 的 输入 校 验 流程 

通过 上 面 的 详细 介绍 ， 不 难 发 现 Struts 2 的 输入 校 验 需 要 经 过 如 下 几 个 步骤 。 

(1) 类 型 转换 器 负责 对 字符 串 的 请 求 参数 执行 类 型 转换 ， 并 将 这 些 值 设 置 成 Action 的 属 
性 值 。 

(2) 在 执行 类 型 转换 过 程 中 可 能 出 现 异常 ， 如 果 出 现 异常 ， 将 异常 信息 保存 到 
ActionContext 中 ，conversionError 拦截 器 负责 将 其 封装 到 fieldError 里 ， 然 后 执行 第 (3) 步 ， 如 
果 转 换 过 程 没 有 异常 信息 ， 则 直接 进入 第 (3) 步 。 

(3) 通过 反射 调用 validateXxx0 方 法 , 其 中 Xxx 是 即将 要 处 理 用 户 请 求 的 处 理 逻 辑 所 对 应 
的 方法 名 。 

(4) 调用 Action 类 里 的 validate() 方 法 。 

(5) 如 果 经 过 上 面 4 步 都 没有 出 现 fieldError, 将 调用 Action 里 处 理 用 户 请 求 的 处 理 方法 ; 
如 果 出 现 了 filedError， 系 统 将 转 入 input 逻辑 视图 所 指定 的 视图 资源 。 

不 喜欢 看 文字 的 读者 ， 可 以 看 下 图 6-3 分 解 。 


6.1.2 ”实例 描述 


输入 校 验 是 一 项 常用 的 技术 ， 通 过 这 种 技术 可 以 校正 用 户 的 输入 ， 从 而 可 以 避免 一 些 不 必 
要 的 错误 。 随 着 数字 化 时 代 的 到 来 ， 这 种 校 验 已 经 随处 可 见 ， 而 在 Web 应 用 当中 尤为 常见 ， 
随处 可 以 看 到 它 的 身影 。 本 案例 我 们 来 制作 一 个 关于 登录 的 输入 验证 。 在 该 实例 中 ， 如 果 用 户 
输入 的 用 户 名 为 特殊 字符 ， 那 么 将 会 出 现 出 错 提示 ， 并 提示 用 户 输出 字符 、 数 字 或 者 两 者 的 组 
合 。 具 体 实现 方法 如 下 。 


<E@—— 
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6-3 ”validate() 方 法 校 验 顺 序 图 


6.1.3 ”实例 应 用 


【 例 6-1】 验证 用 户 输入 是 否 合法 。 

(1) 配置 web.xml( 配 置 FilterDispatcher)。 

(2) 创建 实体 类 User.java， 里 面 有 两 个 属性 ， 一 个 是 username， 
如 下 。 

package com.struts2.model; 

用户 实 人 类 


*@author Administrator 
六 


wf 
public class User { 
private String username;// 用 户 名 


将 请 求 


-个 是 password， 代 码 


讶 
臣 
EE 


审计 丘 昌 
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private String password;// 密 码 
/* 下 面 是 上 面 属性 username、 password 的 set、 get 方法 ， 这 里 省 略 */ 


} 


(3) 创建 登录 Action， 名 为 LoginAction， 在 其 中 编辑 execute() 方 法 ， 把 登录 用 户 对 象 放 
入 Request 对 象 中 ， 同 时 编辑 它 的 validateXxx0 方 法 ， 对 用 户 输 入 数据 进行 判断 ， 代 码 如 下 。 


package com.struts2.actions; 


import 
import 
import 
import 
import 
public 


java.util.regex.Pattern; 
javax.servlet.http.HttpServletRequest; 
org.apache.struts2.ServletActionContext; 
com.opensymphony .xwork2.ActionSsupport; 
com.struts2.model .User; 

class LoginAction extends Actionsupport { 


private User user; 
@Override 
public String execute() throws Exception { 


F 


/太太 


// 获 取 HttpservletRequest 对 象 

HttpServletRequest request=ServletActionContext .getRequest (); 
// 把 从 表单 获取 到 的 User 对 象 存放 到 HttpservletRequest 对 象 中 

request .setAttribute("login", user); 

return "loginSsuccess"; 


* execute() 的 validatexxx 方法 ， 用 于 执行 execute() 之 前 


We 


public void validateExecute(){ 


// 获 取 表单 数据 username 
String uname=user.getUsername (); 
// 判 断 username 是 否 合法 


if (uname==null||!Pattern.matches("\\w{4,25}",uname.trim())){ 


addFieldError("user.username"，" 您 输入 的 用 户 名 必须 是 字母 和 数字 ， 且 长 度 


必须 在 4 到 25 之 间 ! ") 7 


， 

// 获 取 表 单数 据 password 

String pwd=user.getPassword(); 

// 判 断 password 是 否 合法 

if(pwd==null||!Pattern.matches("\\w{4,25}", pwd.trim())){ 
addFieldError ("user.password"， "您 输入 的 密码 必须 是 字母 和 数字 ， 且 长 度 必 


须 在 4 到 25 之 间 ! "); 


} 


} 


/* 下 面 是 上 面 User 对 象 的 set、get 方法 ， 这 里 省 略 */ 


} 


(4) 在 src 目录 下 的 struts-config 文件 夹 中 新 建 login.xml 文件 ， 配 置 LoginAction， 配 置 


如 下 代码 。 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 


< 
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"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 


<package name ="login" extends ="struts-default" > 


<action name ="login" class ="com.struts2.actions.LoginAction" > 
<result name="loginSsuccess">/main.jsp</result> 
<result name="input">/login.jsp</result> 
</action> 
</package > 
</struts> 


(5) 在 WebRoot 文件 夹 下 新 建 login.jsp 页 面 作为 登录 页 面 ， 代 码 片段 如 下 。 


<%@taglib prefix="s" uri="/struts-tags" $%> 
<form name=forml action="login/login.action" method=post> 
<input type=”text” name=”user.username” value="<s:property 
value="user.username"/>"/> 
<input type=”text” name=”user.password” value="<s:property 
value="user.password"/>"/> 
<input type=”submit”value=” 登 录 ”/> 
<s:fielderror/> 
</form> 


(6) 在 src 目录 下 的 struts.xml 文件 中 引入 login.xml 文件 。 


6.1.4 ”运行 结果 


运行 程序 中 的 loginjsp 页 面 , 在 用 户 名 输入 框 中 输入 非 字 母 、 非 数字 , 无 法 登录 到 主页 面 ， 
并 且 提 示 错 误 信息 ， 如 图 6-4 所 示 。 


管理 中 心 全 陆 Yl- 0 - Windowa Internet Explorcr 


[CS 司 加 区 
让 交加 9 -日 OIA- ” 


RAE Ee ] 。 。 各 入 入 的 且 户 和 加 尖 时 导 和 
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p9 Ee |] 伸 
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图 6-4 输入 验证 ， 提 示 错 误 信息 
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6.1.5 实例 分 析 


a 


上 述 案 例 中 ,在 LoginAction 中 的 validateExecute( 方 法 中 验证 用 户 输入 时 并 未 返回 任何 结 
果 ， 在 它 的 execute() 方 法 中 只 是 返回 了 一 个 “loginSuccess” 的 结果 页 面 main.jsp。 但 是 系统 在 
运行 时 ， 进 入 validateExecute() 方 法 后 ， 当 验证 用 户 输入 不 合法 时 跳 转 到 了 login.jsp 页 面 ， 这 
是 为 什么 呢 ? 

当 系统 验证 用 户 输入 不 合法 时 ， 会 自 定 跳 转 至 “INPUT” 所 对 应 的 结果 页 面 ， 而 我 们 在 
login.xml 文 件 中 配置 了 input 所 对 应 的 结果 页 面 正 是 login.jsp, 因此 会 跳 转 至 登录 页 面 login.jsp， 
并 以 <s:fielderror/> 标 签 显示 错误 信息 。 


6.2 基本 输入 校 验 


在 上 一 节 中 介绍 了 在 Action 类 中 编写 代码 对 用 户 输入 数据 进行 校 验 , 然而 , 这 种 验证 方式 
也 存在 着 一 些 问题 。 首 先是 当 验 证 规则 比较 复杂 时 ，Action 类 的 代码 将 变 得 繁杂 不 堪 ， 其 次 是 
某 些 验证 规则 无 法 复 用 ， 例 如 判断 字段 是 否 为 空 、 判 断 字符 串 的 长 度 等 规则 ， 对 于 很 多 字段 来 
说 都 是 需要 的 。 在 上 一 节 中 ， 仅 仅 只 是 完成 了 对 必 填 字段 是 否 合法 的 判断 ， 对 于 字段 的 格式 并 
没有 做 详细 的 验证 ， 编 写 这 样 的 验证 代码 费时 费力 ， 使 得 代码 的 编写 变 成 了 体力 活 。 

正 因为 输入 验证 的 重要 性 和 重复 性 ， 才 有 了 一 些 验证 框架 的 推出 。Struts 2 也 内 置 了 一 个 
验证 框架 ， 开 发 者 可 以 通过 在 外 部 配置 文件 中 定义 验证 规则 的 方式 来 简化 对 输入 数据 的 验证 ， 
从 而 可 以 减轻 开发 者 的 负担 ， 提 高 开发 效率 。 

下 面 将 给 读者 介绍 一 下 如 何 编写 一 个 校 验 规则 文件 来 对 输入 数据 进行 校 验 , 校 验 规则 文件 
如 何 获取 国际 化 文件 中 的 key， 并 提示 错误 信息 及 校 验 文件 的 搜索 规则 是 怎样 的 ? 


9 
是} 视频 教学 ， 光 盘 /videos/06/registValidate.avi 全 长 度 : 7 分 钟 


6.2.1 基础 知识 一 一 基本 输入 校 验 


6.1 节 介 绍 的 手动 校 验方 式 ， 虽 然 比 之 前 的 输入 校 验 有 一 定 的 简化 ， 但 依然 需要 手动 编写 
大 量 的 代码 ， 编 程 依然 很 繁琐 ， 代 码 复 用 性 也 很 低 。Struts 2 提供 了 基于 验证 框架 的 输入 校 验 ， 
在 这 种 校 验方 式 下 ， 所 有 的 输入 校 验 只 需要 通过 指定 简单 的 配置 文件 即 可 。 


1. 编写 校 验 规则 文件 


讲 大 多 的 文字 不 如 用 一 个 实例 来 帮助 理解 直观 ， 下 面 将 用 一 个 已 经 用 到 过 的 实例 ,来 给 读 
者 讲解 一 下 如 何 用 一 个 xml 文件 配置 来 验证 用 户 输入 信息 。 


< 
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将 上 面 的 RegistAction 类 的 execute0 方 法 中 验证 用 户 输入 的 信息 删除 ， 只 返回 一 个 
“SUCCESS” 的 结果 页 面 ， 修 改 后 的 代码 如 下 。 
public class RegistAction extends Actionsupport { 


// 该 请 求 包含 的 4 个 请 求 参 数 


private String name; 


private String pass; 

private int age; 

private Date birth; 

// 在 Action 的 execute 方法 中 进行 验证 

public String execute () throws Exception { 
return SUCCESS; 


} 
/* 下 面 是 上 面 4 个 属性 的 set、get 方法 ， 这 里 省 略 */ 
; 


在 上 面 的 Action 中 , 提供 了 四 个 属性 类 封装 用 户 的 请 求 参 数 , 并 为 这 四 个 参数 提供 了 对 应 
的 setter 和 getter 方法 。 初 看 起 来 ， 这 个 类 是 一 个 普通 JavaBean， 不 是 Action， 但 因为 它 继承 
了 ActionSupport 类 ， 因 此 它 包 含 了 一 个 execute0 方 法 ， 且 该 方法 直接 返回 success 字符 串 。 

采用 Struts 2 的 校 验 框架 时 ， 只 需要 为 该 Action 指定 一 个 校 验 文件 即 可 。 校 验 文件 是 一 个 
XML 配置 文件 ， 该 文件 指定 了 Action 的 属性 必须 满足 特殊 的 规则 ， 下 面 是 该 应 用 中 Action 的 
校 验 文 件 的 代码 。 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 校 验 配置 文件 的 DTD 信息 --> 
<!DOCTYPE validators PUBLIC 
"”-//openSymphony Group//XWork Validator 1.0.2//EN" 
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> 
<!-- 校 验 文件 的 根 元 素 --> 
<validators> 

<!-- 校 验 Action 的 name 属性 --> 

<field name="name"> 

<!-- 指定 name 属性 必须 满足 必 填 规则 --> 


<field-validator type="requiredstring"> 


<param name="trim">true</param> 
<message> 必 须 输入 名 字 </message> 
</field-validator> 
<!-- 指定 name 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message> 您 输入 的 用 户 名 只 能 是 字母 和 数字 , 且 长 度 必须 在 4 到 25 之 间 </message> 
</field-validator> 
</field> 
<!-- 校 验 Action 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 pass 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
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<message> 必 须 输入 密码 </message> 
</field-validator> 
<!-- 指定 pass 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message> 您 输入 的 密码 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 </message> 
</field-validator> 
</field> 
<!-- 指定 age 属性 必须 在 制定 范围 内 --> 
<field name="age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">150</param> 
<message> 年 龄 必须 在 1 到 150 之 间 </message> 
</field-validator> 
</field> 
<!-- 指 定 birth 属性 必须 在 指定 范围 内 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 下 面 指定 日 期 字符 串 时 ， 必 须 使 用 本 Locale 的 日 期 格式 --> 
<param name="min">1900-01-01</param> 
<param name="max">2010-02-21</param> 
<message> 年 龄 必须 在 $ {min} 到 $ {max} 之 间 </message> 
</field-validator> 
</field> 
</validators> 


Struts 2 的 校 验 文件 规则 与 Struts 1 的 校 验 文件 设计 方式 不 同 ，Stmuts 2 中 每 个 Action 都 有 
-个 校 验 文件 ， 而 且 这 个 校 验 文件 的 命名 有 一 定 的 规范 性 ， 大 致 可 以 分 为 两 种 。 
@ Action 级 别 校 验 命名 格式 : 


ActionClassName-validation.xml 


@ Action 中 某 个 方法 的 校 验 命名 格式 : 


ActionClassName-ActionAliasName-validation.xml 


外 ”这 里 的 ActionAliasName(Action 别名 ) 指 的 是 在 struts.xml 文件 中 配置 的 Action 
注意 name= 二 “XXX” 的 XXX 名 称 ， 而 不 是 method=“xxx” 的 名 称 。 
前 面 的 ActionClassName 和 ActionAliasName 是 可 以 改变 的 ， 后 面 的 -validation.xml 部 分 总 
是 固定 的 , 且 该 文件 应 该 被 保存 在 与 Action class 文 件 相 同 的 路 径 下 .例如 ,本 应 用 的 Action class 
文件 保存 在 WEB-INF/classes/com/struts2/actions 路 径 下 , 故 该 校 验 文件 也 应 该 保存 在 该 路 径 下 。 
增加 了 该 校 验 文件 后 ， 其 他 部 分 无 需 任何 修改 ， 系 统 自 动 会 加 载 该 文件 ， 当 用 户 提交 请 求 
时 ，Struts 2 的 校 验 框架 会 根据 该 文件 对 用 户 请 求 进行 校 验 。 如 果 用 户 输入 不 满足 校 验 规 则 ， 
将 可 以 看 到 如 图 6-5 所 示 的 界面 。 


< 轩 一 


6-5 ”使 用 校 验 框架 提示 验证 信息 


从 上 图 中 可 以 看 出 ， 这 种 基于 Struts 2 校 验 框架 的 校 验 方式 完全 可 以 替代 手动 校 验 ， 而 且 
这 种 校 验 方式 的 可 重用 性 非常 高 ， 只 需要 在 配置 文件 中 配置 校 验 规则 ， 即 可 完成 数据 校 验 ， 无 
需 用 户 书写 任何 的 数据 校 验 代码 。 
2. 国际 化 提示 信息 
在 上 面 的 数据 校 验 中 ， 所 有 的 提示 信息 都 是 用 编码 的 方式 写 在 配置 文件 中 ,这 种 方式 显然 
不 利于 程序 国际 化 。 
1) 通过 key 指定 国际 化 提示 信息 
当 查 看 每 个 校 验 文件 时 ， 发 现 每 个 <field-validator.…./> 元 素 都 包含 了 一 个 必 填 的 
<message.../> 子 元 素 ， 这 个 子 元 素 中 的 内 容 就 是 校 验 失败 后 的 提示 信息 。 为 了 国际 化 该 提示 信 
息 ， 为 message 元 素 指定 key 属性 ， 该 key 属性 指定 是 国际 化 提示 信息 对 应 的 key。 
下 面 是 改写 后 的 校 验 规则 文件 代码 ， 命 名 为 RegistAction-reg-validation.xml。 
] <validators> 
<!-- 校 验 Action 的 name 属性 --> 
<field name="name"> 
<!-- 指定 name 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message key="name.requried"/> 
</field-validator> 
<!-- 指定 name 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message key="name.regex"/> 


</field-validator> 
</field> 
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<!-- 校 验 Action 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 pass 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message key="pass.requried"/> 
</field-validator> 
<!-- 指定 pass 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message key="pass.regex"/> 
</field-validator> 
</field> 
<!-- 指定 age 属性 必须 在 制定 范围 内 --> 
<field name="age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">150</param> 
<message key="age.range"/> 
</field-validator> 
</field> 
<!-- 指 定 birth 属性 必须 在 指定 范围 内 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 下 面 指定 日 期 字符 串 时 ， 必 须 使 用 本 Locale 的 日 期 格式 --> 
<param name="min">1900-01-01</param> 
<param name="max">2010-02-21</param> 
<message key="birth.range"/> 
</field-validator> 
</field> 
</validators> 


从 上 面 校 验 规则 文件 中 可 以 看 出 ,没有 直接 给 校 验 后 的 提示 信息 ， 每 个 message 元 素 只 是 
指定 了 一 个 key 属性 ， 该 key 属性 就 是 校 验 失败 后 给 出 的 国际 化 提示 信息 对 应 的 key。 

因为 上 面 的 校 验 文件 中 指定 了 许多 国际 化 信息 的 key， 所 以 必须 在 国际 化 资源 文件 中 增加 
对 应 的 key， 即 在 RegistAction 所 在 的 同 目录 下 新 建 一 个 RegistAction.properties 文件 ， 增 加 如 
下 Entry。 


# 违 反 用 户 名 必须 输入 的 提示 信息 

name .requried= 您 必须 输入 用 户 名 ! 

# 违 反 用 户 名 必须 匹配 正则 表达 式 的 提示 信息 

name - regex= 您 输入 的 用 户 名 只 能 是 字母 和 数字 ， 且 长 度 必 须 在 4 到 25 之 间 ! 
# 违 反 密码 必须 输入 的 提示 信息 

pass.requried= 您 必须 输入 密码 ! 

# 违 反 密码 必须 匹配 正则 表达 式 的 提示 信息 

pass . regex= 您 输入 的 密码 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 ! 

# 违 反 年 龄 必须 在 指定 范围 的 提示 信息 

age-range= 您 的 年 龄 必须 在 $ {min} 和 $ {max} 之 间 ! 
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# 违 反 生日 必须 在 指定 范围 的 提示 信息 
pirth.range= 您 的 生日 必须 在 ${min} 和 $ {max} 之 间 ! 
接 下 来 , 我 们 来 看 看 运行 结果 是 否 和 上 一 节 运 行 结果 一 样 ! 运行 regjsp 页 面 , 输入 一 个 年 
龄 为 190， 单 击 Regist 按钮 ， 出 现 如 图 6-6 所 示 的 界面 。 


6-6 ”国际 化 提示 信息 校 验 输入 数据 


通过 上 面 的 讲解 , 你 是 否 觉得 Struts 2 真 的 很 伟大 呢 ? 它 不 仅 提供 了 <message key=“ 国 际 化 
消息 ”/> 的 元 素来 调用 国际 化 ， 还 提供 了 另 一 种 形式 ， 下 面 就 来 为 读者 讲解 一 下 Struts 2 提供 的 
另 一 种 形式 调用 国际 化 资源 文件 提示 信息 。 

2) ”通过 ActionSupport 的 getText0 方 法 获取 国际 化 提示 信息 

首先 将 输入 页 面 的 表单 元 素 改 为 使 用 Struts 2 标签 来 生成 表单 ， 并 且 为 该 表单 增加 
validate=“true” 属 性 即 可 。 

将 上 面 的 regjsp 页 面 的 代码 改 为 如 下 代码 。 

<s:form action="reg/reg.action" method="post" validate="true"> 

<!-- 使 用 s:textfield 标签 生成 文本 输入 框 --> 
<s:textfield label="username" name="name"/> 
<s:password label="password" name="pass"/> 
<s:textfield label="user age" name="age"/> 
<s:textfield label="birthday" name="birth"/> 
<s:submit value="Regist"/> 

</s:form> 

根据 Struts 2 的 官方 文档 所 说 的 ， 只 要 将 JSP 页 面 改 成 如 上 的 形式 ， 即 应 该 可 以 完成 客户 
端 校 验 。 为 了 能 满足 用 户 的 编码 爱好 ，Struts 2 还 提供 了 另 一 种 方式 来 输出 国际 化 资源 文件 : 
${getText(“ 消 息 key”)}， 于 是 将 校 验 文件 改 为 如 下 形式 。 


<validators> 


<!-- 校 验 Action 的 name 属性 --> 
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<field name="name"> 
<!-- 指定 name 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message>$ {getText ("name.requried") }</message> 
</field-validator> 
<!-- 指定 name 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message>$ {getText ("name.regex") }</message> 
</field-validator> 
</field> 
<!-- 校 验 Action 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 pass 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message>$ {getText ("pass.requried") }</message> 
</field-validator> 
<!-- 指定 pass 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message>$ {getText ("pass.regex") }</message> 
</field-validator> 
</field> 
<!-- 指定 age 属性 必须 在 制定 范围 内 --> 
<field name="age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">150</param> 
<message>${getText ("age.range") }</message> 
</field-validator> 
</field> 
<!-- 指 定 birth 属性 必须 在 指定 范围 内 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 下 面 指定 日 期 字符 串 时 ， 必 须 使 用 本 Locale 的 日 期 格式 --> 
<param name="min">1900-01-01</param> 
<param name="max">2010-02-21</param> 
<message>${getText ("birth.range") }</message> 
</field-validator> 
</field> 
</validators> 


在 上 面 的 校 验 规则 文件 中 , 也 没有 直接 校 验 失败 的 提示 信息 , 而 是 通过 调用 ActionSupport 
的 getText0 方 法 来 取得 国际 化 的 提示 信息 。 这 种 配置 方式 比 前 面 的 配置 文件 要 繁琐 一 点 , 但 对 
于 需要 使 用 客户 端 校 验 的 情况 ， 还 是 建议 使 用 这 种 配置 方式 。 

此 时 ， 如 果 浏 览 者 的 输入 不 再 符合 校 验 规则 ， 将 看 到 如 图 6-7 所 示 的 界面 。 
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6-7 ”客户 端 校 验 效果 


从 上 图 6-7 中 可 以 看 出 ， 尽 管 使 用 客户 端 校 验 ， 却 看 不 到 弹出 JavaScript 的 警告 框 ， 这 种 
效果 看 起 来 与 服务 器 端 校 验 几 乎 完全 相同 。 
》 客户 端 校 验 依然 是 基于 JavaScript 完成 的 ， 由 于 JavaScript 脚 本 本 身 的 限制 ， 有些 
注意 服务 器 端 校 验 不 能 转换 成 客户 端 校 验 。 也 就 是 说 ， 并 不 是 所 有 的 服务 器 端 校 验 都 
可 以 转换 成 客户 端 校 验 的 。 
客户 端 校 验 仅 仅 支持 如 下 几 种 校 验 器 。 
required validator ( 必 填 校 验 器 ) 
requiredstring validator ( 必 填 字符 串 校 验 器 ) 
stringlength validator (字符 串 长 度 校 验 器 ) 
regex validator (表达 式 校 验 器 ) 
email validator (邮件 校 验 器 ) 
url validator (网 址 校 验 器 ) 
int validator (整数 校 验 器 ) 
double validator ( 双 精 度数 字 校 验 器 ) 
客户 端 校 验 有 两 个 值得 注意 的 地 方 。 
@ Stmts 2 的 <s:form.../> 元 素 有 一 个 theme 属性 ， 不 要 将 该 属性 指定 为 simple。 
@ 不 要 在 校 验 规则 文件 的 错误 提示 信息 中 ， 直 接 使 用 key 来 指定 国际 化 提示 信息 。 


3. 校 验 文件 的 搜索 规则 


Strmts 2 的 一 个 Action 中 可 能 包含 多 个 处 理 逻 辑 ， 当 一 个 Action 类 中 包含 多 个 类 似 于 
execute 的 方法 时 ， 每 个 方法 都 是 一 个 处 理 逻 辑 。 不 同 的 处 理 逻 辑 可 能 需要 不 同 的 校 验 规则 ， 
Struts 2 也 提供 了 不 同 Action 指定 不 同 校 验 规则 的 支持 。 

当 需 要 让 一 个 Action 可 以 处 理 多 个 请 求 时 ， 应 该 在 配置 该 Action 时 指定 method 属性 。 通 
过 这 种 方式 ， 就 可 以 将 一 个 Action 处 理 类 配置 成 多 个 逻辑 Action。 

在 上 面 的 Action 类 中 增加 一 个 login 方法 ， 该 login 方法 不 做 任何 处 理 ， 只 是 简单 地 返回 
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succcess 字符 串 。 下 面 在 src 目录 下 struts-config 文件 夹 下 的 reg.xml 文件 中 将 该 Action 类 配置 
成 两 个 逻辑 Action。 下 面 是 配置 这 两 个 逻辑 Action 的 配置 代码 。 
<package name ="reg" extends ="struts-default" > 
<!-- 配置 一 个 名 为 reg 的 Action， 对 应 的 处 理 逻 辑 为 RegistAction 的 execute 方法 
一 -> 
<action name ="reg" class ="com.Struts 2.actions.RegistAction" > 
<result name="input">/reg.jsp</result> 
<result name="success">/success.jsp</result> 
</action > 
<!-- 配置 一 个 名 为 userLogin 的 Action， 对 应 的 处 理 逻 辑 为 RegistAction 的 login 
方法 --> 
<action name="userLogin" class="com.struts2.actions.RegistAction"> 
<result name="input">/reg.jsp</result> 
<result name="success">/success.jsp</result> 
</action> 
</package > 


假设 上 面 两 个 Action 的 校 验 规则 不 同 ， 注 册 时 的 校 验 规则 还 是 之 前 的 校 验 规则 ， 但 登录 
的 校 验 规则 需要 增加 一 些 校 验 。 如 果 按 之 之 前 的 方式 来 指定 校 验 规则 文件 ， 这 个 校 验 规则 文 
件 肯定 分 不 清楚 到 底 要 校 验 哪个 处 理 罗 辑 。 为 了 能 精确 控制 每 个 校 验 罗 辑 ，Struts 2 允许 通过 
为 校 验 规则 文件 名 增加 Action 别名 来 指定 具体 需要 校 验 的 处 理 逻 辑 。 即 就 是 采用 前 面 提 到 过 的 
形式 。 

<ActionClassName>-<ActionAliasName>-validation.xml 


例如 ， 需 要 为 login 处 理 逻 辑 单 独 指定 校 验 规则 ， 则 校 验 文件 的 文件 名 为 : 
RegistAction-login-validation.xml( 该 文件 也 需要 与 RegistAction 的 class 文件 放 在 同一 路 径 下 )。 
该 文件 的 内 容 片段 如 下 。 
<validators> 
<!-- 校 验 Action 的 name 属性 --> 


<field name="name"> 
<!-- 指定 name 属性 必须 和 密码 相同 --> 
<field-validator type="fieldexpression"> 
<param name="expression"><! [CDATA[ (name == pass)]]></param> 
<message>$ {getText ("namepass") }</message> 
</field-validator> 
</field> 
</validators> 


在 regjsp 页 面 中 添加 一 个 value=“ 登 录 ” 的 按钮 作为 提交 按钮 ， 并 修改 前 面 的 注册 校 验 规 
则 文件 名 为 RegistAction-validationxml ， 同 时 要 修改 regjsp 页 面 中 的 <s:form 
action=“Teg/userLogin.action”.../>。 运 行 regjsp 页 面 ， 单 击 “ 登 录 ” 按 钮 ， 将 看 到 如 图 6-8 所 示 
的 页 面 。 

从 运行 结果 来 看 ，RegistAction-validation xml 文件 中 的 校 验 规 则 ， 依 然 会 对 名 为 userLogin 
的 Action 起 作用 。 实 际 上 ， 名 为 userLogin 的 Action 中 包含 的 校 验 规则 是 
RegistAction-validation xml 和 RegistAction-userLogin-validation.xml 两 个 文件 中 规则 的 总 和 。 
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除 此 之 外 ， 还 有 一 种 情形 一 一 系统 中 包含 了 两 个 Action: BaseAction 和 RegistAction， 其 
中 RegistAction 继承 了 BaseAction， 且 两 个 Action 都 指定 了 对 应 的 配置 文件 ， 则 RegistAction 
对 应 Action 的 校 验 规则 实际 上 是 RegistAction-validation.xml 和 BaseAction-validation.xml 两 个 
文件 规则 的 总 和 。 

假设 系统 有 两 个 Action: BaseAction 和 RegistAction， 则 系统 搜寻 规则 文件 顺序 如 下 。 

(1) BaseAction-validation.xml 

(2) BaseAction- 别 名 -validation .xml 

(3) RegistAction-validation.xml 

(4) RegistAction- 别 名 -validation.xml 

这 种 搜寻 与 其 他 搜寻 不 同 的 是 ， 即 使 找到 第 一 个 校 验 规则 ， 系 统 还 会 继续 搜索 ， 不 管 有 没 
有 这 四 份 文件 ， 也 不 管 是 否 找到 匹配 文件 ， 系 统 总 是 按 固 定 顺 序 搜索 。 

》 Stmuts 2 搜索 规则 文件 是 从 上 而 下 ， 实 际 用 的 校 验 规则 是 所 有 校 验 规则 的 总 和 。 如 
注意 果 两 个 校 验 文件 中 指定 的 校 验 规则 冲突 ， 则 从 后 面 文件 中 的 校 验 规则 取 值 。 


6.2.2 ”实例 描述 


今天 ， 我 正在 吃 午 饭 ， 客 户 一 个 电话 让 我 不 得 不 放下 饭碗 跑 回 公司 。 是 什么 让 我 这 么 紧张 
呢 ? 我 的 天 呢 ! 客户 要 修改 功能 ， 并 且 修 改 的 功能 还 不 少 呢 ! 这 个 程序 是 我 们 以 前 的 开发 者 做 
的 ， 也 不 知 怎么 想 的 ， 对 那些 用 户 输入 数据 进行 校 验 ， 全 部 都 是 在 Action 中 使 用 validateXxxO 
方法 进行 校 验 。 现 在 客户 要 修改 功能 ， 需 要 添加 字段 ， 就 意味 着 要 对 新 增 字段 进行 数据 校 验 ， 
要 修改 Action 吗 ? 不 会 吧 ! 修改 的 功能 可 不 少 啊 ， 这 要 一 个 Action 一 个 Action 的 修改 吗 ? 于 
是 ， 我 从 下 午 忙 到 第 二 天 晚上 才 把 事情 做 完 时 ， 气 的 客户 脸 都 绿 了 。 殊 不 知 不 她 我 ， 要 是 这 个 
系统 把 用 户 输入 数据 的 验证 用 一 个 校 验 规则 文件 写 ， 那 修改 起 来 多 方便 啊 ! 

下 面 我 将 把 系统 中 的 注册 功能 给 读者 分 享 一 下 。 


mt >> 


第 6 章 “探索 数据 校 验 的 奥妙 8 


6.2.3 ”实例 应 用 


【 例 6-2】 对 用 户 注 册 时 的 输入 数据 进行 验证 。 
(1) 修改 用 户 信 息 实体 类 Userjava， 新 增 属性 email 和 age， 修 改 后 的 代码 如 下 。 


public class User { 

Private String username;// 用 户 名 

private String password;// 密 码 

private String email;// 邮 箱 地 址 

private int age;// 年 龄 

/* 下 面 是 上 面 所 有 属性 的 get 、set 方法 ， 这 里 省 略 */ 
} 


(2) 新 建 用 户 注册 Action, 命名 为 UserRegistAction, 继承 ActionSupport, 并 重 写 execute() 
方法 ， 在 execute0 方 法 中 无 任何 操作 ， 只 是 返回 结果 页 面 。UserRegistAction 的 内 容 如 下 。 


public class UserRegistAction extends RARctionSupport { 
private User user; 


private String verifyPassword;// 确 认 密 码 
@Override 


public String execute() throws Exception { 
return SUCCESS; 


} 
/* 下 面 是 上 面 两 个 属性 的 get 、set 方法 ， 这 里 省 略 */ 
} 


(3) 在 struts-config 文件 夹 下 新 建 userRegist.xml 文件 ， 配 置 UserRegistAction 类 ， 代 码 
如 下 。 
<package name ="userRegist" extends ="struts-default" > 
<action name="userRegist" 
class="com.struts2.actions.UserRegistAction"> 
<result name="success">/success.jsp</result> 
<result name="input">/userRegist.jsp</result> 
</action> 
</package > 


(4) 在 WebRoot 下 新 建 userRegistjsp 页 面 作 为 注册 页 面 ， 提 交 至 userRegist/userRegist. 
action， 代 码 如 下 。 


<s:form action="userRegist/userRegist.action" method="post" validate="true"> 
<s:textfield name="user .username" label=" 用 户 名 " required="true"/> 
<s:password name="user.password” label=" 密 码 " required="true"/> 
<s:password name="verifyPassword" label=" 确 认 密码 " 
required="true"/> 
<s:textfield name="user.age"” label=" 年 龄 " value="10" 
required="true"/> 
<s:textfield name="user.email" label=" 上 邮箱 " required="true"/> 
<s:submit value=" 注 册 "/> 
</s:form> 
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(5) 到 目前 为 止 , 已 可 以 运行 userRegistjsp 页 面 , 无 论 输 入 什么 , 都 可 以 转 到 “SUCCESS” 
所 对 应 的 成 功 页 面 successjsp。 但 这 样 有 可 能 会 使 系统 骨 溃 。 因 此 必须 对 用 户 的 输入 数据 做 一 
些 校 验 。 编 辑 校 验 规 则 文件 UserRegistAction-validation.xml， 对 用 户 输入 的 所 有 数据 进行 校 验 ， 
校 验 规则 文件 内 容 如 下 。 


<validators> 
<!-- 针对 user.username 字段 的 验证 规则 --> 
<field name="user.username"> 
<!-- 使 用 requiredstring 验证 器 , 确保 user .username 字段 值 不 为 null, 也 不 为 "" 
一 -> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message key="error.username.required"/> 
</field-validator> 
<!-- 使 用 stringlength 验证 器 , 确保 user .username 字段 值 的 字符 长 度 在 4 到 12 之 
间 --> 
<field-validator type="stringlength"> 
<param name="minLength">4</param> 
<param name="maxLength">12</param> 
<message key="error.username.length"/> 
</field-validator> 
</field> 
<!-- 针对 user .password 字段 的 验证 规则 --> 
<field name="user.password"> 
<field-validator type="requiredstring"> 
<message key="error.password.required"/> 
</field-validator> 
<field-validator type="stringlength"> 
<param name="minLength">4</param> 
<param name="maxLength">8</param> 
<message key="error.password.length"/> 
</field-validator> 
</field> 
<!-- 确认 密码 字段 的 验证 规则 --> 
<field name="verifyPassword"> 
<field-validator type="requiredstring"> 
<message key="error.verifyPassword.required"/> 
</field-validator> 
<! 使 用 fieldexpression 验证 器 --> 
<field-validator type="fieldexpression"> 
<!-- 使 用 oGNL 表达 式 来 判断 确认 密码 和 密码 的 一 致 性 --> 
<param name="expression">verifyPassword==user.password</param> 
<message key="error.verifyPassword.identical"/> 
</field-validator> 
</field> 
<!-- 针对 user .age 字段 的 验证 规则 --> 


<field name="user.age"> 


<field-validator type="int"> 
<param name="minLength">10</param> 
<param name="maxLength">100</param> 
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<message key="error.age.invalid"/> 
</field-validator> 
</field> 
<!-- 针对 user .email 字段 的 验证 规则 --> 
<field name="user.email"> 
<field-validator type="requiredstring"> 
<message key="error.email.required"/> 
</field-validator> 
<!-- 使 用 email 验证 器 ， 确 保 user .email 字段 值 是 合法 的 邮件 地 址 --> 
<field-validator type="email"> 
<message key="error.email.invalid"/> 
</field-validator> 
</field> 
</validators> 


校 验 规则 文件 UserRegistAction-validation.xml 与 UserRegistAction 的 class 位 于 同一 目录 下 ， 
这 里 都 位 于 comy/struts2/actions 路 径 下 。 
(6) 编辑 国际 化 文件 UserRegistAction.properties， 内 容 如 下 。 


error.username. required= 请 输入 用 户 名 ! 

error.username .length= 用 户 名 长 度 必须 在 $ {minLength} 到 ${maxLength} 之 间 ! 
error.password. required= 请 输入 密码 
error.password.1length= 密 码 长 度 必须 在 $ {minLength} 到 $ {maxLengthj 之 间 ! 
error.age.invalid= 年 龄 必须 在 $ {minLength} 到 $ {maxLength} 之 间 ! 
error.email.requi red= 请 输入 邮箱 ! 

error.email.invalid= 您 的 邮箱 地 址 无 效 ! 

verifyPassword= 确 认 密 码 ! 

error.verifyPassword. required= 请 再 次 输入 密码 ! 

error.verifyPassword. identical= 两 次 输入 的 密码 不 一 致 ! 


6.2.4 运行 结果 


运行 userRegistjsp 页 面 ， 如 果 输 入 错误 ， 出 现 如 图 6-9 所 示 的 界面 。 


6-9 用 户 注册 提示 错误 信息 


ET 
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6.2.5 ”实例 分 析 


a 


上 案例 中 , 我 们 对 确认 密码 进行 了 验证 , 运用 type="fieldexpression" 的 field-validator 元 素 ， 
同时 联合 <param name="expression">verifyPassword=user.password</param> 要 求 两 次 输入 的 密 
码 要 一 致 ， 其 中 verifyPassword 指 的 是 在 Action 中 的 属性 ，fieldexpression validator 是 字段 表达 
式 验 证 器 。 使 用 邮箱 地 址 验证 器 (email validator) 对 用 户 输入 的 邮箱 地 址 进行 了 验证 ， 无 需 写 正 
则 表达 式 。 验 证 字符 串 是 否 是 合法 邮件 地 址 的 正则 表达 式 已 经 内 置 在 EmailValidator 验证 器 中 。 


6.3 ”内置 校 验 器 


就 如 拦截 器 一 样 , 有 自 定义 的 当然 也 有 内 置 (内 建 ) 的 拦截 器 , 这 样 才能 使 Struts 2 框架 更 加 
的 完美 。 

下 面 就 为 读者 讲解 一 下 Struts 2 内 置 的 校 验 器 有 哪些 ， 以 及 每 个 检验 器 都 具有 什么 样 的 功 
能 ， 在 何 种 情况 下 使 用 。 


ce 视频 教学 : 光盘 /videos/06/SystemValidate.avi 全 长 度 : 12 分 钟 
光盘 /videos/06/conversion.avi 全 长 度 : 8 分钟 
光盘 /videos/06/date.avi @ 长 度 : 7 分 钟 
光盘 /videos/06/email.avi @ 长 度 : 7 分 钟 
光盘 /videos/06/expression.avi 名 长 度 :10 分钟 
光盘 /videos/06/int.avi 人 @ 长 度 :10 分钟 
光盘 /videos/06/othervalidate.avi 全 长 度 : 6 分 钟 
光盘 /videos/06/requiredstring.avi @@ 长 度 : 7 分 名 
光盘 /videos/06/stringlength_avi @@ 长 度 : 7 分 名 


6.3.1 基础 知识 一 一 内 置 校 验 器 


Struts 2 提供 了 大 量 的 内 置 校 验 器 ， 这 些 内 置 的 校 验 器 可 以 满足 大 部 分 应 用 的 校 验 需求 ， 
开发 者 只 需要 使 用 这 些 校 验 器 即 可 。 

Struts 2 针对 常用 的 验证 器 需求 ， 提 供 了 13 个 验证 器 。 使 用 WinRAR 打开 Struts 2 发 布 包 
的 解压 缩 文件 中 的 xwork-core-2.1.6jar 文件 ， 在 该 压缩 文件 的 com/opensymphony/xwork2/ 
validator/validators 路 径 下 找到 一 个 default.xml 文件 ， 这 个 文件 就 是 Struts 2 默认 的 校 验 器 注册 
文件 。 该 文件 的 代码 如 下 。 

<validator name="required™ 
class="com.opensymphony .xwork2.validator.validators.RequiredFieldValidator"/> 
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<validator name="requiredstring"™" 
class="com.opensymphony .xwork2.validator.validators.RequiredSstringValidator 
"/> 
<validator name="int" 
class="com.opensymphony .xwork2.validator.validators.IntRangeFieldValidator"/> 
<validator name="long" 
class="com.opensymphony .xwork2 .validator.validators.LongRangeFieldVvalidator"/> 
<validator name="short™ 
class="com.opensymphony .xwork2.validator.validators.ShortRangeFieldValidator"/> 
<validator name="double" 
class="com.opensymphony .xwork2 .validator.validators. 
DoubleRangeFieldValidator"/> 
<validator name="date" 
class="com.opensymphony .xwork2 .validator.validators.DateRangeFieldValidator"/> 
<validator name="expression" 
class="com.opensymphony .xwork2.validator.validators.ExpressionValidator"/> 
<validator name="fieldexpression" 
class="com.opensymphony .xwork2 .validator.validators. 
FieldExpressionValidator"/> 
<validator name="email" 
class="com.opensymphony .xwork2.validator.validators.EmailValidator"/> 
<validator name="url™" 
class="com.opensymphony.xwork2.validator.validators.URLValidator"/> 
<validator name="visitor" 
class="com.opensymphony .xwork2.validator.validators.VisitorFieldValidator"/> 
<validator name="conversion" 
class="com.opensymphony .xwork2.validator.validators. 
ConversionErrorFieldValidator"/> 
<validator name="stringlength" 
class="com.opensymphony .xwork2.validator.validators. 
stringLengthFieldValidator"/> 
<validator name="regex" 
class="com.opensymphony .xwork2 .validator.validators.RegexFieldValidator"/> 
<validator name="conditionalvisitor" 
class="com.opensymphony .xwork2.validator.validators. 
ConditionalVisitorFieldValidator"/> 
</validators> 


上 面 代码 中 注册 的 校 验 器 ， 就 是 Struts 2 全 部 的 内 置 校 验 器 。 

通过 上 面 代码 可 以 看 出 ,注册 一 个 校 验 器 是 如 此 简单 : 通过 一 个 <validator... 人 > 元 素 即 可 注 
册 一 个 校 验 器 ， 每 个 <validator... 人 > 元素 的 name 属性 指定 该 校 验 器 的 名 字 ，class 属性 指定 该 校 
验 器 的 实现 类 。 

如 果 开 发 者 开发 了 一 个 子 集 的 校 验 器 ， 则 可 以 通过 添加 一 个 validation xml 文件 (该 文件 应 
该 放 在 WEB-INF/classes 路 径 下 ) 来 注册 校 验 器 。 validation.xml 文件 的 内 容 也 是 由 多 个 
<validator ... 人 > 元 素 组 成 ， 每 个 <validator .…. 人 > 元 素 注册 一 个 校 验 器 。 


@ ”如果 Struts 2 系统 在 WEB-INF/classes 路 径 下 找到 一 个 validators.xml 文件 , 则 不 会 

注意 | ”再 加 载 系统 默认 的 default.xml 文件 。 因 此 ， 如 果 开 发 者 提供 了 自己 的 校 验 器 注册 
文件 (validators .xml 文件 )， 一 定 要 把 defaultxml 文件 里 的 全 部 内 容 复 制 到 
validators xml 文件 中 。 但 是 也 曾经 有 人 证 实 的 结果 却 与 此 相反 : 即使 没有 在 
validators xml 文件 里 注册 ， 那 些 内置 的 验证 程序 也 可 以 使 用 它们 。 我 建议 大 家 为 
了 安全 起 见 ， 还 是 在 validators.xml 文件 中 注册 一 下 吧 ! 


怀 人 mm 
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下 面 将 为 读者 介绍 一 下 Struts 2 内 置 的 这 13 个 验证 器 的 使 用 情况 。 
1. 必 填 验 证 器 (required validator) 


RequiredFieldValidator 验证 器 检查 指定 的 字段 是 否 为 null。 该 验证 器 可 以 接受 一 个 参数 : 
fieldName， 指 定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需要 这 个 
参数 。 

采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 

<validators> 

<!-- 使 用 非 字段 校 验 器 风格 来 配置 必 填 校 验 器 --> 
<!-- 使 用 type 属性 指定 使 用 required 验证 器 --> 
<validator type="required"> 

<!-- 通过 fieldName 参数 来 指定 要 验证 的 字段 --> 


<param name="fieldName">user.username</param> 


<message> 请 输入 用 户 名 ! </message> 


</validator> 
</validators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 使 用 字段 校 验 器 风格 来 配置 必 填 校 验 器 ， 校 验 user .username 属性 --> 
<!-- 通过 name 属性 指定 要 验证 的 字段 名 --> 
<field name="user.username"> 
<!-- 使 用 type 属性 指定 使 用 required 验证 器 --> 
<field-validator type="required"> 
<message> 请 输入 用 户 名 ! </message> 
</field-validator> 
</field> 
</validators> 


2. 必 填 字符 串 验证 器 (requiredstring validator) 

RequiredString Validator 验证 器 检查 一 个 字符 串 字段 值 是 否 为 null， 并 且 其 长 度 大 于 0( 即 
不 为 “”)。 该 验证 器 可 以 接受 两 个 参数 : 

@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 


要 这 个 参数 。 

@ tim: 布尔 值 ,指定 在 执行 长 度 检 测 之 前 是 否 调用 String 的 trim0 方 法 删除 首尾 的 空格 。 
默认 值 为 true。 

采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 

<validators> 


<!-- 使 用 非 字段 校 验 器 配置 风格 来 配置 必 填 字符 串 校 验 器 --> 

<validator type="requiredstring"> 
<param name="fieldName">user.username</param> 
<param name="trim">true</param> 
<message> 请 输入 用 户 名 ! </message> 

</validator> 
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</validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 


<validators> 
<!-- 使 用 字段 校 验 器 配置 风格 来 配置 必 填 字符 串 校 验 器 --> 
<field name="user.username"> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message> 请 输入 用 户 名 </message> 
</field-validator> 
</field> 
</validators> 


3. 字符 串 长 度 验证 器 (stringlength validator) 
StringLengthFieldValidator 验证 器 检查 一 个 字符 串 字段 值 是 否 在 一 定 的 长 度 范 围 内 。 该 验 
证 器 可 以 接受 四 个 参数 ， 分 别 如 下 。 
@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 字段 验证 器 ， 则 不 需要 
这 个 参数 。 
@ maxLength: 指定 字段 值 的 最 大 长 度 。 如 果 没 有 指定 该 参数 ， 则 不 检查 最 大 长 度 。 
@ minLength: 指定 字段 值 的 最 小 长 度 。 如 果 没 有 指定 该 参数 ， 则 不 检查 最 小 长 度 。 
@ trim: 布尔 值 ,指定 在 执行 长 度 检测 之 前 是 否 调 用 String 的 trim0 方 法 删除 首尾 的 空格 。 
默认 值 为 true。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 
<!-- 使 用 非 字 段 校 验 器 配置 风格 来 配置 字符 串 长 度 校 验 器 --> 
<validator type="stringlength"> 
<param name="fieldName">user.username</param> 
<param name="minLength">10</param> 


<param name="maxLength">18</param> 
<param name="trim">true</param> 


<message> 你 输入 的 用 户 名 长 度 必须 在 $ {minLength} 到 $ {maxLength} 之 间 ! 


</message> 
</validator> 
</validators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 使 用 字段 校 验 器 配置 风格 来 配置 字符 串 长 度 校 验 器 --> 
<field name="user.username"> 
<field-validator type="stringlength"> 
<param name="minLength">10</param> 
<param name="maxLength">18</param> 
<param name="trim">true</param> 
<message> 你 输入 的 用 户 名 长 度 必 须 在 $ {minLength} 到 $ {maxLength} 之 间 ! 


</message> 


< 于 —— 
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</field-validator> 
</field> 


</validators> 


4. 整数 验证 器 (int validator) 
IntRangeFieldValidator 验证 器 检查 指定 的 整数 是 否 在 一 定 的 范围 内 。 该 验证 器 可 以 接受 三 


个 参数 ， 如 下 。 
@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 
要 这 个 参数 。 


@ min: 指定 整数 的 最 小 值 。 如 果 没 有 指定 该 参数 ， 则 不 检查 最 小 值 。 
@ max: 指定 整数 的 最 大 值 。 如 果 没 有 指定 该 参数 ， 则 不 检查 最 大 值 。 
采用 非 字 段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 


<validators> 
<! 一 -使 用 非 字 段 校 验 器 配置 风格 来 配置 整数 校 验 器 --> 
<validator type="int"> 
<param name="fieldName">user.age</param> 
<param name="min">1</param> 
<param name="max">100</param> 


<message> 你 输入 的 年 龄 无 效 ， 必 须 在 $ {min} 到 $ {max} 之 间 ! </message> 


</validator> 
</validators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 使 用 字段 校 验 器 配置 风格 来 配置 整数 校 验 器 --> 
<field name="user.age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">100</param> 
<message> 你 输入 的 年 龄 无 效 ， 必 须 在 $ {min} 到 $ {max} 之 间 ! </message> 
</field-validator> 
</field> 
</validators> 


5. 双 精 度 浮 点 数 验 证 器 (double validator) 
DoubleRangeFieldValidator 验证 器 检查 指定 的 双 精 度 浮 点 数 是 否 在 一 定 的 范围 内 。 该 验证 
器 可 以 接受 五 个 参数 ， 如 下 所 示 。 

@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 
要 这 个 参数 。 

@ minInclusive: 指定 双 精 度 浮 点 数 的 最 小 值 ， 待 检测 的 值 可 以 等 于 这 个 最 小 值 。 如 果 没 
有 指定 该 参数 ， 则 不 检查 这 个 值 。 

@ ”maxInclusive: 指定 双 精 度 浮 点 数 的 最 大 值 ， 待 检测 的 值 可 以 等 于 这 个 最 大 值 。 如 果 
没有 指定 该 参数 ， 则 不 检查 这 个 值 。 
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@ ”minExclusive: 指定 双 精 度 浮 点 数 的 最 小 值 ， 待 检测 的 值 必须 大 于 这 个 最 小 值 。 如 果 
没有 指定 该 参数 ， 则 不 检查 这 个 值 。 
@ ”maxExclusive: 指定 双 精 度 浮 点 数 的 最 大 值 ， 待 检测 的 值 必须 小 于 这 个 最 大 值 。 如 果 
没有 指定 该 参数 ， 则 不 检查 这 个 值 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 
<!-- 使 用 非 字段 校 验 器 配置 风格 来 配置 双 精 度 浮 点 数 验 证 器 --> 
<validator type="double"> 
<param name="fieldName">price</param> 
<param name="minInclusive">10.1</param> 


<param name="maxInclusive">100.1</param> 
<message> 商 品 价格 必须 在 $ {minInclusive} 到 $ {maxInclusive} 范 围 内 ! 


</message> 
</validator> 
</validators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 使 用 字段 校 验 器 配置 风格 来 配置 双 精 度 浮 点 数 验证 器 --> 
<field name="price"> 
<field-validator type="double"> 
<param name="minExclusive">10.123</param> 
<param name="maxExclusive">99.999</param> 
<message> 商 品 价格 必须 在 $ {minExclusive} 到 $ {maxExclusive]} 之 间 ! 
</message> 
</field-validator> 
</field> 
</validators> 


6. 日 期 验证 器 (date validator) 
DateRangeFieldValidator 验证 器 检查 给 出 的 日 期 是 否 在 指定 的 范围 内 。 该 验证 器 可 以 接受 
三 个 参数 。 
@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 
要 这 个 参数 。 


@ min: 指定 日 期 的 最 小 值 。 如 果 没 有 指定 该 参数 ， 则 不 检查 最 小 值 。 
@ max: 指定 日 期 的 最 大 值 。 如 果 没 有 指定 该 参数 ， 则 不 检查 最 大 值 。 


有 $ ”如果 没 有 指定 日 期 转换 器 , 框架 将 使 用 XWorkBasicConverter 来 进行 日 期 转换 , 默 
注意 认 使 用 Date.SHORT 格式 来 做 日 期 转换 ， 使 用 程序 中 指定 的 locale 或 者 系统 默认 
的 locale。 


按照 惯例 ， 请 读者 来 看 看 下 面 的 代码 。 


<validators> 


<!-- 使 用 非 字 段 校 验 器 配置 风格 来 配置 日 期 校 验 器 --> 


<validator type="date"> 


< 
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<param name="fieldName">user.birth</param> 

<param name="min">01/01/1990</param> 

<param name="max">01/01/2011</param> 

<message> 出 生日 期 必须 在 1990 年 01 月 01 日 到 2011 年 01 月 01 日 之 间 !</message> 


</validator> 


<!-- 使 用 字段 校 验 器 配置 风格 来 配置 日 期 校 验 器 --> 
<field name="user.birth"> 
<field-validator type="date"> 
<param name="min">01/01/1990</param> 
<param name="max">01/01/2011</param> 
<message> 出 生日 期 必须 在 $ {min} 到 $ {max} 之 间 ! </message> 
</field-validator> 
</field> 
</validators> 


7. 表达 式 验证 器 (expression validator) 


Expression Validator 是 一 个 普通 验证 器 (不 能 使 用 <field> 元 素来 声明 )， 它 基于 OGNL 表达 
式 进行 验证 。 该 验证 器 可 以 接受 一 个 参数 : expression。 这 个 参数 指定 要 计算 的 OGNL 表达 式 ， 
该 表达 式 基 于 值 栈 进行 求 值 。 表 达 式 计算 的 结果 必须 是 Boolean 值 ， 如 果 为 tue， 则 验证 通过 ; 
如 果 为 false， 则 验证 失败 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 
<validator type="expression"> 
<param name="expression">user.password==verifyPassword</param> 
<message> 两 次 输入 的 密码 不 一 致 ! </message> 
</validator> 
</validators> 


8. 字段 表达 式 验证 器 (fieldexpression validator) 


FieldExpressionValidator 验证 器 使 用 OGNL 表达 式 验 证 字段 。 该 验证 器 可 以 接受 两 个 参数 ， 
@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 
要 这 个 参数 。 
@ ”expression: 指定 要 计算 的 OGNL 表达 式 ， 该 表达 式 基 于 值 栈 进行 求 值 。 表 达 式 计 算 
的 结果 必须 是 Boolean 值 ， 如 果 为 tue， 则 验证 通过 ; 如果 为 false， 则 验证 失败 。 
采用 非 字 段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 
<!-- 使 用 非 字段 校 验 器 配置 风格 来 配置 字段 表达 式 校 验 器 --> 
<validator type="fieldexpression"> 


<param name="fieldName">verifyPassword</param> 
<param name="expression">verifyPassword==user.password</param> 
<message> 两 次 输入 的 密码 不 一 致 ! </message> 
</validator> 
</validators> 
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采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 


<validators> 
<!-- 使 用 字段 校 验 器 配置 风格 来 配置 字段 表达 式 校 验 器 --> 
<field name="verifyPassword"> 
<field-validator type="fieldexpression"> 
<param name="expression">verifyPassword==user.password</param> 
<message> 两 次 输入 的 密码 不 一 致 ! </message> 
</field-validator> 
</field> 
</validators> 


9. 正则 表达 式 验证 器 (regex validator) 


RegexFieldValidator 验证 器 使 用 正则 表达 式 验证 一 个 字符 串 字 段 值 。 该 验证 器 可 以 接受 四 
个 参数 。 
@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 
要 这 个 参数 。 
@ expression: 指定 用 于 验证 字段 值 的 正则 表达 式 。 该 参数 是 必需 的 。 
@ caseSensitive: 布尔 值 ， 指 定 字段 值 是 否 按照 大 小 写 相关 的 方式 来 匹配 正则 表达 式 。 
该 参数 是 可 选 的 ， 默 认 值 是 tue。 
@ trim: 布尔 值 ， 指 定 在 进行 正则 表达 式 匹配 之 前 ， 是 否 应 该 删除 字符 串 首尾 的 空格 。 
该 参数 是 可 选 的 ， 默 认 值 是 tue。 
相信 读者 看 完 下 面 的 代码 会 居然 大 悟 的 。 
<validators> 
<!-- 使 用 非 字段 校 验 器 配置 风格 来 配置 正则 表达 式 校 验 器 --> 
<validator type="regex"> 
<param name="fieldName">user.zipcode</param> 
<param name="expression"><! [CDATA[[0-9] \d{5} (?!1\d)]]></param> 
<message> 邮 政 编码 无 效 ! </message> 


</validator> 


<!-- 使 用 字段 校 验 器 配置 风格 来 配置 正则 表达 式 校 验 器 --> 
<field name="user.zipcode"> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[[0-9] \d{5} (2!\d)]]></param> 
<message> 邮 政 编码 无 效 ! </message> 
</field-validator> 
</field> 
</validators> 


10. 邮件 地 址 验证 器 (email validator) 

EmailValidator 验证 器 采用 正则 表达 式 验 证 一 个 字符 串 是 否 是 合法 的 邮件 地 址 ， 如 果 指 定 
的 字段 值 为 null 或 者 为 “”， 则 该 验证 器 只 是 简单 的 返回 ， 并 不 将 它 报告 为 一 个 验证 错误 。 

用 于 验证 字符 串 是 否 合法 邮件 地 址 的 正则 表达 式 为 : 


<A 寺 一 
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Mb'(*E A-2a-z0=9=]+(\\.[ RAR-Za=-Z0-9-]+)*e@(0IBR=-Za=-z0=-9-])+(ANN [A-Za—z0-9—]+)#*( 
(NN [A=Za=z0=9]12r 3) (NN A=Za=z0=-9] {2 MN: [A~2Za=z0-9]127T)) 3)Nb 
随 着 技术 的 不 断 发 展 , 上 面 的 正则 表达 式 可 能 不 能 完全 履 盖 实际 的 电子 邮件 地 址 。 
注意 此 时 ， 建 议 开发 者 使 用 正则 表达 式 校 验 器 来 完成 邮件 校 验 。 
这 个 正则 表达 式 已 经 内 置 在 EmailValidator 验证 器 中 。 EmailValidator 验证 器 可 以 接受 一 个 
参数 : fieldName。 这 个 参数 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 


则 不 需要 这 个 参数 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 使 用 非 字段 校 验 器 配置 风格 来 配置 邮件 校 验 器 --> 
<validator type="email"> 
<param name="fieldName">user.email</param> 


<message> 邮 箱 地 址 无 效 ! </message> 


</validator> 
</validators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 使 用 字段 校 验 器 风格 来 配置 邮件 校 验 器 ， 校 验 user .email 属性 --> 
<field name="user.email"> 
<field-validator type="email"> 
<message> 邮 箱 地 址 无 效 ! </message> 
</field-validator> 
</field> 
</validators> 


11. 网 址 验证 器 (url validator) 


URLValidator 验证 器 检查 指定 的 字段 值 是 否 是 字符 串 ， 并 且 是 合法 的 URL。 该 验证 器 可 
以 接受 一 个 参数 : fieldName。 这 个 参数 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字 
段 验 证 器 ， 则 不 需要 这 个 参数 。 

下 面 的 代码 就 是 使 用 网 址 验证 器 的 例子 。 


<validators> 
<!-- 使 用 非 字段 校 验 器 风格 来 配置 网 址 校 验 器 --> 
<validator type="url"> 
<param name="fieldName">homePage</param> 
<!-- 指 定 校 验 失败 提示 信息 --> 
<message> 无 效 的 链接 地 址 ! </message> 


</validator> 


<!-- 使 用 字段 校 验 器 配置 风格 来 配置 网 址 校 验 器 ， 校 验 homePage 属性 --> 
<field name="homePage"> 
<field-validator type="url"> 


<message> 无 效 的 链接 地 址 ! </message> 


mA >> 
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</field-validator> 
</field> 
</validators> 


12. visitor 验 证 器 (visitor validator) 
关于 visitor 验证 器 的 用 法 ， 请 参见 后 面 章节 。 
13. 转换 验证 器 (conversion validator) 


ConversionErrorFieldValidator 验证 器 检查 指定 字段 在 类 型 转换 过 程 中 是 否 出 现 转换 错误 。 
该 验证 器 可 以 接受 两 个 参数 。 

@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 
要 这 个 参数 。 

@ repopulateField: 布尔 值 ， 指 定 出 现 类 型 转换 错误 时 ， 是 否 保留 字段 的 原始 值 。 在 出 
现 类 型 转换 错误 时 ， 请 求 会 被 导向 到 INPUT 结果 视图 ， 当 我 们 希望 在 发 生 错误 的 字 
段 中 显示 原始 输入 的 值 时 ， 应 该 将 该 参数 设置 为 tue。 

采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 。 

<validators> 
<!-- 非 字段 校 验 器 风格 来 配置 转换 校 验 器 --> 
<validator type="conversion"> 

<param name="fieldName">intField</param> 

<!-- 指定 类 型 转换 失败 后 ， 返 回 输入 页 面 保留 原来 的 错误 输入 信息 --> 
<param name="repopulateField">true</param> 
<message> 不 能 转换 成 Integer 类 型 ! </message> 


</validator> 
</validators> 
采用 字段 校 验 器 配置 风格 时 ， 给 校 验 器 的 配置 示例 如 下 。 
<validators> 


<!-- 字段 校 验 器 配置 风格 来 配置 转换 校 验 器 --> 
<field name="intField"> 
<field-validator type="conversion"> 
<param name="repopulateField">true</param> 
<message> 不 能 转换 成 Integer 类 型 ! </message> 
</field-validator> 
</field> 
</validators> 


6.3.2 ”实例 描述 


上 次 做 的 用 户 注册 功能 真是 “失败 ”， 我 费 了 九 牛 二 虎 之 力 才 做 好 。 现 在 项 目 经 理 又 让 
换 …… 说 到 我 们 的 项 目 经 理 这 个 人 ， 我 们 几 个 都 会 皱 紧 眉 头 ， 他 是 一 个 性 格 有 点 古怪 ， 脾 气 很 
偶 的 一 个 人 ， 说 一 不 二 ， 管 你 有 理 没 理 ， 他 说 的 你 都 得 听 。 他 看 到 我 改写 的 用 户 注册 输入 验证 
规则 文件 后 直接 把 项 目 给 我 发 了 过 来 ， 让 我 重 写 。 问 其 原因 ， 才 知 必须 要 用 非 字 段 校 验 器 风格 
类 配置 所 有 的 字段 输入 校 验 器 。 
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6.3.3 ”实例 应 用 


【 例 6-3】 为 用 户 注册 输入 数据 校 验 改变 “风格 ”。 
修改 校 验 规则 文件 (UserRegistAction-validation.xml), 使 用 非 字段 校 验 器 风格 来 对 用 户 输入 


的 所 有 数据 进行 配置 相应 的 校 验 器 。 修 改 后 的 内 容 如 下 。 


<validators> 


<!-- 使 用 非 字段 校 验 器 配置 风格 对 user .username 属性 配置 必 填 校 验 器 --> 
<validator type="requiredstring"> 

<!-- 指定 需要 校 验 的 字段 名 : user.username --> 

<param name="fieldName">user.username</param> 

<!-- 指定 在 执行 长 度 检测 之 前 删除 首尾 的 空格 --> 

<param name="trim">true</param> 

<message key="error.username.required"/> 
</validator> 
<!-- 使 用 非 字段 校 验 器 配置 风格 对 user .username 属性 配置 字符 串 长 度 校 验 器 --> 
<validator type="stringlength"> 

<!-- 指定 需要 校 验 的 字段 名 : user.username --> 

<param name="fieldName">user.username</param> 

<!-- 指定 user.username 属性 字符 串 的 最 小 长 度 --> 

<param name="minLength">4</param> 

<!-- 指定 user.username 属性 字符 串 的 最 大 长 度 --> 

<param name="maxLength">12</param> 

<!-- 指定 校 验 失败 的 提示 信息 --> 

<message key="error.username.length"/> 
</validator> 
<!-- 使 用 非 字 段 校 验 器 配置 风格 对 user .password 属性 配置 必 填 校 验 器 --> 
<validator type="requiredstring"> 

<param name="fieldName">user.password</param> 

<!-- 指定 校 验 失败 后 的 提示 信息 --> 

<message key="error.password.required"/> 
</validator> 
<!-- 使 用 非 字 段 校 验 器 配置 风格 对 user .password 属性 配置 字符 串 长 度 校 验 器 --> 
<validator type="stringlength"> 

<param name="minLength">4</param> 

<param name="maxLength">8</param> 

<message key="error.password.length"/> 
</validator> 
<!-- 使 用 非 字 段 校 验 器 配置 风格 对 Action 中 的 verifyPassword 属性 配置 必 填 校 验 器 --> 
<validator type="requiredstring"> 

<!-- 指定 要 校 验 的 字段 : verifyPassword --> 

<param name="fieldName">verifyPassword</param> 

<message key="error.verifyPassword.required"/> 
</validator> 
<!-- 使 用 非 字 段 校 验 器 配置 风格 对 verifyPassword 属性 配置 字段 表达 式 校 验 器 --> 
<validator type="fieldexpression"> 

<param name="fieldName">verifyPassword</param> 
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<!-- 指定 逻辑 表达 式 --> 各 
<param name="expression">verifyPassword==user.password</param> 
<!-- 指定 校 验 失 败 的 提示 信息 --> 
<message key="error.verifyPassword.identical"/> 
</validator> 
<!-- 使 用 非 字段 校 验 器 对 user .age 属性 配置 整数 校 验 器 --> 
<validator type="int"> 
<param name="fieldName">user.age</param> 
<!-- 指定 user.age 属性 的 最 小 值 --> 
<param name="min">10</param> 
<!-- 指定 user.age 属性 的 最 大 值 --> 
<param name="max">100</param> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message key="error.age.invalid"/> 
</validator> 
<!-- 使 用 非 字段 校 验 器 风格 对 user .email 属性 配置 必 填 校 验 器 --> 
<validator type="requiredstring"> 
<param name="fieldName">user.email</param> 
<message key="error.email.required"/> 
</validator> 
<!-- 使 用 非 字 段 校 验 器 风格 对 user .email 属性 配置 邮件 地 址 校 验 器 --> 
<validator type="email"> 
<param name="fieldName">user.email</param> 
<message key="error.email.invalid"/> 
</validator> 
</validators> 


6.3.4 运行 结果 


运行 userRegist.jsp 页 面 ， 输 入 信息 不 合法 ， 验 证 失败 ， 提 示 错 误 信 息 。 如 图 6-10 所 示 。 


6-10” 非 字段 校 验 器 风格 提示 错误 信息 
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6.3.5 ”实例 分 析 


es 


从 上 面 的 案例 中 可 以 得 知 校 验 器 有 两 种 风格 的 配置 : 非 字 段 和 字段 校 验 器 配置 风格 。 在 
6.2.2 节 我 们 使 用 了 字段 校 验 器 配置 风格 配置 了 校 验 器 ， 在 本 节 中 我 们 使 用 了 非 字段 校 验 器 配 
置 风格 ， 这 两 种 配置 风格 都 能 完成 对 用 户 输入 数据 的 校 验 工作 ， 读 者 根据 自己 的 爱好 选择 一 
种 进行 配置 即 可 。 


6.4 开发 自己 的 验证 器 


看 到 这 节 的 标题 你 一 定 心 中 充满 了 疑惑 : “不 是 说 Struts 2 内 置 的 验证 器 可 以 满足 大 部 分 
的 校 验 需求 吗 ? 怎么 还 要 开发 自己 的 验证 器 呢 ? ”这 和 拦截 器 是 一 样 的 : 有 内 置 拦截 器 ， 也 有 
自 定义 拦截 器 。 也 许 正 是 因为 Struts 2 存在 着 这 样 的 优势 而 成 为 目前 Web 开发 中 较为 流行 的 
框架 。 

下 面 就 给 读者 介绍 一 下 如 何 开发 自己 的 验证 器 以 及 使 用 自 定义 验证 器 


A 
下 >) 视频 教学 ， 光盘 /videos/06/MyValidate.avi 侠 长 度 :10 分钟 


6.4.1 基础 知识 


开发 属于 自己 的 验证 器 


即使 你 对 Struts 2 内 置 验证 程序 的 内 部 情况 一 无 所 知 ， 也 不 影响 你 使 用 它们 。 可 如 果 你 想 
编写 你 自己 的 验证 程序 ， 就 必须 对 用 来 实现 Struts 2 验证 程序 的 各 个 类 和 它们 的 注册 机 制 有 一 
定 的 了 解 。 

1. Validator 接 口 介绍 


验证 程序 必须 实现 Validator 接口 ， 它 是 com.opensymphony.xwork2.validator 包 的 一 部 分 。 
图 6-11 给 出 了 这 个 接口 、 它 的 子 接口 和 实现 类 。 

在 下 图 中 ， 我 省 略 了 包 的 名 字 。Validator、FieldValidator 和 ShortCircuitableValidator 接口 
属于 com.opensymphony.xwork2.validator 包 ， 其 他 的 组 件 属于 com.opensymphony.xwork2. 
validator.validators 包 。Validator 接口 的 定义 如 下 。 


package com.opensymphony .xwork2.validator; 
public interface Validatort{ 

void setDefaultMessage (String message); 

String getDefaultMessage (); 

String getMessage (Object object); 

void setMessageKey (String key); 

String getMessageKey () 7 

void setValidatorType (String type); 


第 6 章 “探索 数据 校 验 的 奥妙 上 


String getValidatorType (); 

void setValidatorContext (ValidatorContext validatorContext); 
ValidatorContext getValidatorContext () 7 

void validate (Object object) throws ValidationException; 


图 6-11 Validator 接口 和 支持 类 型 << 接 器 之 > 
Validation ea [ey a] 
器 中 加 载 了 一 个 验证 程序 之 后 ， 这 个 拦截 器 将 调用 关公 站 二 人 KIRA fdator 


并 把 当前 的 ValidatorContext 对 象 传递 给 它 ， 这 样 我 们 可 以 访问 当前 动作 。 接 下 来 ，Validation 
拦截 器 将 调用 validate 方法 并 把 需要 验证 的 对 象 传递 给 它 。validate 方法 是 在 编写 一 个 自 定义 的 
验证 程序 时 需要 覆盖 的 方法 。 
@ 对 便捷 类 ValidatorSupport 或 FieldValidatorSupport 进行 扩展 要 比 自行 实现 
提示 Validator 接口 容易 的 多 。 如果 要 创建 一 个 普通 的 验证 程序 ( 非 字 段 验 证 程序 ), 请 扩 
展 ValidatorSupport 类 ; 如 果 要 编写 一 个 字段 验证 程序 ， 请 扩展 
FieldValidatorSupport 类 ; 如 果 设 计 的 验证 程序 能 够 接受 一 个 输入 参数 ， 需 要 为 这 
个 参数 增加 一 个 相应 的 属性 。 例如 ， 如 果 验 证 程序 允许 一 个 minValue 参数 ， 还 需 
要 增加 一 个 名 为 minValue 的 属性 ， 并 为 它 编写 getter 方法 和 setter 方法 。 
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2. ValidatorSupport 类 介绍 


从 上 图 6-11 可 以 看 出 , ValidatorSupport 类 实现 了 Validator 接口 , 在 ValidatorSupport 类 中 
增加 了 几 个 方法 ， 读 者 可 以 从 验证 程序 类 里 调用 它们 。 下 面 三 个 是 便捷 方法 。 

@ protected java.lang.Object getFieldValue(Java.lang.String name.java.lang.Object object) 
trows ValidationException: 它 返回 Object 对 象 的 name 字段 的 值 。 

@ protected void addActionError(java.lang.Object actionError): 这 个 方法 的 主要 功能 是 增 
加 一 个 动作 错误 信息 。 

protected void addFieldError(java.lang.String propertyName.java.lang.Object object): 这 个 
方法 的 主要 功能 是 增加 一 个 字段 错误 信息 。 

如 果 读 者 编写 的 是 一 个 非 字 段 验证 程序 ， 在 验证 失败 时 需要 从 validate 方法 调用 
addActionError 方法 ; 如 果 读者 编写 的 是 一 个 字段 验证 程序 , 在 验证 失败 时 需要 从 validate 方法 
调用 addFieldError 方法 。 

FieldValidatorSupport 类 扩展 了 ValidatorSupport 类 并 新 增 了 propertyType 和 fieldName 两 
个 属性 。 


3. RequiredStringValidator 类 介绍 


在 对 输入 数据 配置 字符 串 非 空 验证 校 验 器 requiredstring 时 就 是 用 RequiredStringValidator 
类 实现 的 ， 它 的 源 代码 如 下 。 


package com.opensymphony .xwork2.validator.validators; 
import com.opensymphony.xwork2.validator.ValidationException; 
public class RequiredstringValidator extends FieldValidatorSupport{ 
private boolean doTrim=true; 
public void setTrim(boolean trim){ 
doTrim=trim; 
} 
public boolean getTrim(){ 
return doTrim; 
} 
public void validate (Object object) throws ValidationException{ 
String fieldName=getFieldName (); 
Object value=this.getFieldValue (fieldName,object); 
if(!(value instanceof String) ) 1{ 
addFieldError (fieldName,object); 
}elsef{ 
String s=(String)value; 
if(doTrim){ 
s=s.trim(); 
} 
if(s.length()==0){ 
addFieldError (fieldName, object); 
} 
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从 RequiredStringValidator 类 的 源码 中 可 以 看 出 , requiredstring 验证 程序 可 以 接受 一 个 trim 
参数 ， 所 以 RequiredStringValidator 类 需要 有 一 个 相应 的 trim 属性 。 如 果 有 一 个 trim 参数 被 传 
递 给 这 个 验证 程序 ，Validation 拦截 器 就 会 调用 trim 属性 的 setter 方法 。validate 方法 负责 具体 
进行 有 关 的 验证 。 如 果 验 证 失败 ， 这 个 方法 必须 调用 addFieldError 方法 。 


6.4.2 ”实例 描述 


前 几 天 我 QQ 号 被 次 了 ， 因 为 我 的 QQ 密码 被 人 给 改 了 ， 后 来 我 同事 说 QQ 号 一 般 不 容易 
被 盗 的 (要 是 容易 被 盗 的 话 ， 腾 讯 早 倒闭 了 ! 呵呵 ……)， 但 是 我 的 为 什么 那么 容易 被 人 家 猜 中 
密码 呢 ? 究 其 原因 ， 原 来 是 因为 我 密码 设 的 太 简单 。 因 为 QQ 号 是 公开 的 ， 只 要 密码 猜 中 了 ， 
资 QQ 就 像 是 吃饭 一 样 的 容易 。 呵 呵 …… 我 的 密码 是 : 123456789， 所 以 很 容易 被 别人 猜 中 啊 ! 
所 以 我 下 定 决心 ， 再 申请 一 个 QQ 号 码 ， 这 次 把 密码 设置 的 复杂 点 ， 安 全 性 能 强 点 的 。 至 少 要 
包括 大 、 小 写字 母 加 数字 吧 ! 

同时 我 也 想到 了 以 后 给 客户 做 软件 也 不 能 疏忽 这 个 问题 ， 直 接 让 用 户 注册 账号 时 ， 输 入 的 
密码 必须 要 复杂 点 ， 和 否则 用 户 在 本 软件 中 的 信息 丢失 了 ， 损 失 可 不 小 啊 ! 


6.4.3 ”实例 应 用 


【 例 6-4】 为 用 户 注册 输入 密码 配置 “ 强 口令 字 ” 校 验 器 。 

这 个 例子 的 最 终 成 果 是 一 个 用 来 检查 口 名 字 强 度 的 strongpass 验证 程序 : 只 有 那些 至 少 包 
含 一 个 数字 、 一 个 小 写字 母 和 一 个 大 写字 母 的 口令 才 会 被 认为 是 一 个 强 口令 字 。 此 外 ， 这 个 验 
证 程序 还 可 以 接受 一 个 minLength 参数 ， 用 户 可 以 通过 这 个 参数 来 设置 一 个 可 接受 口令 字 的 最 
小 长 度 。 

(1) strongpass 验证 程序 的 支持 类 是 com.struts2.validator.StrongPassValidator， 这 个 类 扩展 
自 FieldValidatorSupport 类 。validate 方法 将 调用 isStrongPass(String fieldName) 方 法 来 测试 口令 
字 的 强度 。com.struts2.validator.StrongPassValidator 的 内 容 如 下 。 


package com.struts2.validator; 
import com.opensymphony .xwork2.validator.ValidationException; 
import com.opensymphony.xwork2.validator.validators.FieldValidatorSupport; 
/A* 
* 验证 程序 的 支持 类 
* @author Administrator 
大 
public class StrongPassValidator extends FieldValidatorSsupport { 
private int minLength=-1;// 定 义 文本 的 最 小 长 度 
public int getMinLength() { 
return minLength; 
1 
public void setMinLength (int minLength) { 
this.minLength = minLength; 
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} 


// 验 证 程序 


public void validate (Object object) throws ValidationException { 


据 的 值 


} 


String fieldName=getFieldName (); 
String value=(String) getFieldValue (fieldName, object);// 获 取 用 户 输入 数 


// 如 果 用 户 输入 的 为 null 或 ""， 验 证 失败 ， 返 回 错误 信息 
if(value==null||lvalue.length()==0){ 
return; 


} 
// 如 果 定义 的 文本 最 小 长 度 大 于 -1 且 输 入 的 数据 值 小 于 这 里 定义 的 最 小 长 度 ， 返 回 错 误 信息 
if((minLength>-1)&& (value.length()<minLength)){ 
addFieldError (fieldName, object);// 添 加 错误 信息 
else if(!isStrongPass (value) ) {// 如 果 用 户 输入 的 数据 不 是 强 口令 ， 则 返回 错误 信息 
addFieldError (fieldName,object); 
} 


// 定 义 三 个 变量 

private static final String GROUP 1="abcdefghijklmnopqrstuvwxyz"; 
private static final String GROUP 2="ABCDEFGHIJKLMNOPQRSTUVWXY2"; 
private static final String GROUP 3="0123456789"; 

// 是 否 是 强 口令 


protected boolean isStrongPass (String pass){ 


// 定 义 三 个 boolean 变量 ， 分 别 记录 用 户 输入 数据 中 是 否 有 小 写字 母 、 大 写字 母 、 数 字 
boolean conl=false; 
boolean con2=false; 
boolean con3=false; 
int length=pass.length();// 获 取 输 入 的 长 度 
for (Int i=0;i<length;i++){ 
if(conl && con2 && con3){// 如 果 用 户 输入 的 数据 中 既 有 小 写字 母 也 有 大 写字 母 
还 有 数字 ， 则 跳出 循环 
break; 
a 
string character=pass.substring (i,i+1);// 依 次 获取 用 户 输 入 的 数据 字符 
if (GROUP_1.contains (character)){// 如 果 检 查 的 用 户 输入 数据 中 存在 小 写字 
母 ， 则 设置 con1=true， 继 续 遍历 
conl=true; 
continue; 
} 
if(GROUP 2.contains (character)){// 如 果 检 查 出 用 户 输入 数据 中 存在 大 写字 
母 ， 则 设置 con2=true， 继 续 遍 历 
con2=true; 
continue; 
} 
if (GROUP_3.contains (character)){// 如 果 检 查 出 用 户 输入 数据 中 存在 数字 ， 则 
设置 con3=true 
con3=true; 
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. 
return (conl && con2 && con3) ;// 返 回 用 户 输入 数据 中 是 否 包 含 大 、 小 写字 母 和 数 
字 ， 是 一 个 boolean 值 


(2) 在 类 路 径 下 (src 目录 下 或 WEB-INF/classes 子 目录 下 ) 新 创建 validators.xml 文件 , 用 于 
对 strongpass 验证 程序 进行 注册 。 


<?xml Version="1.0"” encoding="UTF-8"?> 
<!DOCTYPE validators PUBLIC 
"-//OpenSymphony Group//XWork Validator Config 1.0//EN" 
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd"> 
<validators> 
<!-- 配置 strongpass 校 验 器 --> 
<validator name="strongpass" 
class="com.struts2.validator.StrongPassValidator"/> 
</validators> 


在 注册 了 定制 验证 程序 之 后 ， 就 可 以 像 使 用 Struts 2 内 置 验证 程序 那样 使 用 它 了 。 
(3) 在 这 个 例子 中 ， 还 是 用 前 面 案例 中 的 User 类 和 UserRegistAction 类 ， 无 需 任何 修改 。 
需要 修改 UserRegistAction-validation.xml 文件 中 的 校 验 密码 规则 为 以 下 所 示 。 
<!-- 使 用 非 字 段 校 验 器 配置 风格 对 user .password 属性 配置 必 填 校 验 器 --> 


<validator type="requiredstring"> 
<param name="fieldName">user.password</param> 
<!- 指定 校 验 失败 后 的 提示 信息 --> 
<message key="error.password.required"/> 
</validator> 
<!-- 使 用 非 字段 校 验 器 配置 风格 对 user .password 属性 配置 强 命令 校 验 器 --> 
<validator type="strongpass"> 
<param name="fieldName">user.password</param> 
<param name="minLength">8</param> 
<message key="error.password.length"/> 
</validator> 


(4) 修改 国际 化 配置 文件 UserRegistAction.properties 中 的 error.password.length 值 如 下 
所 示 。 


error.password.length= 为 了 您 的 安全 ， 密 码 必须 包含 大 、 小 写字 母 和 数字 ， 且 长 度 必 须 大 于 
${minLength} 位 ! 


6.4.4 运行 结果 


运行 userRegistjsp 页 面 ， 当 用 户 输入 的 密码 没有 同时 包含 数字 、 小 写字 母 和 大 写字 母 ， 提 
示 错 误 信 息 ， 如 图 6-12 所 示 。 


< 全 mm 


6-12 自 定义 校 验 器 应 用 


6.4.5 “实例 分 析 


ne 


在 上 案例 中 ， 在 类 路 径 下 (WEB-INF/classes 子 目 录 下 ) 的 validators.xml 文件 中 注册 了 一 个 
名 称 为 strongpass 的 校 验 器 ， 使 得 在 使 用 这 个 校 验 器 时 和 使 用 Struts 2 内 置 校 验 器 完全 一 样 ， 
因此 ， 可 以 在 对 密码 配置 强 口 令 字 校 验 器 时 ， 直 接 使 用 type="strongpass" 即 可 。 同 时 在 
StrongPassValidator 类 中 定义 了 变量 minLength， 因 此 在 strongpass 校 验 器 中 配置 param name= 
“minLength”， 在 强 口令 字 支 持 类 (StrongPassValidator) 中 可 获取 minlength 的 值 。 


6.5 ”使 用 visitor 字 段 验 证 器 复 用 验证 


前 面 一 节 我 们 是 为 RegistAction 类 编写 了 验证 文件 ， 但 其 中 大 多 数 的 验证 都 是 针对 User 
对 象 的 ， 如 果 有 其 他 的 Action 也 要 使 用 User 对 象 ， 就 需要 为 这 些 Action 重新 编写 针对 User 
对 象 的 验证 规则 。 在 实际 应 用 中 ， 经 常会 有 这 样 的 一 种 需求 ， 就 是 为 domain 或 model 对 象 定 
义 一 些 验证 规则 ， 然 后 在 所 有 的 Action 或 其 他 使 用 这 些 对 象 的 类 中 复 用 它们 。 要 做 到 这 一 点 ， 
可 以 利用 Struts 2 提供 的 VisitorFieldValidator 验证 器 。 
下 面 将 介绍 一 下 如 何 利用 visitor 验证 程序 。 
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6.5.1 基础 知识 一 一 VisitorFieldValidator 验 证 器 介绍 


VisitorFieldValidator 验证 器 简称 visitor 验证 器 ， 它 可 以 提高 代码 的 可 重用 性 ， 它 告诉 验证 
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框架 查找 Action 的 属性 所 属 的 类 型 对 应 的 验证 文件 并 进行 验证 。VisitorFieldValidator 可 以 处 理 
简单 的 对 象 属性 ， 也 可 以 处 理 对 象 集合 或 者 对 象 数组 。 

VisitorFieldValidator 验证 器 可 以 接受 三 个 参数 。 

@ fieldname: 指定 要 验证 的 字段 名 。 如 果 使 用 <field> 元 素来 声明 该 字段 验证 器 ， 则 不 需 

要 这 个 参数 。 

@ context: 指定 验证 发 生 的 上 下 文 。 该 参数 是 可 选 的 。 

@ ”appendPrefix: 布尔 值 , 指定 要 添加 到 字段 上 的 前 缀 。 该 参数 是 可 选 的 ,默认 值 是 true。 

无 论 做 什么 事 都 需要 用 事实 来 征服 人 ， 下 面 举 个 例子 给 读者 介绍 一 下 它 的 作用 ， 相 信 读 者 
会 忱 然 大 悟 的 ! 

假设 有 一 个 名 为 Customer 的 动作 类 ， 它 有 一 个 Address 类 型 的 address 属性 ， 而 Address 
类 又 有 5 个 属性 (streetName、streetNumber、city、state 和 ZipCode)。 为 了 验证 给 定 的 Address 
对 象 ( 它 是 Customer 动作 类 的 一 个 属性 ) 的 ZipCode 属性 ， 通 常会 在 一 个 Customer-validation. 
xml 文件 里 写 出 一 个 下 面 的 field 元 素 。 

<field name="address.zipCode"> 

<field-validator type="requiredstring"> 
<message>Zip Code must not be empty</message> 


</field-validator> 
</field> 


忘记 怎样 才能 在 OGNL 表达 式 里 引用 一 个 复杂 对 象 了 吗 ? 
假设 还 有 一 个 Employee 动 作 类 也 使 用 Address 作 为 一 种 属性 类 型 .如 果 Employee 的 address 
属性 需要 使 用 与 Customer 中 的 address 属性 同样 的 验证 规则 ， 将 有 一 个 与 Customer- 
validation.xml 文件 的 内 容 完 全 一 样 的 Employee-validation.xml 文件 。 
这 显然 是 一 种 元 余 , 而 visitor 验证 程序 可 以 帮助 你 把 需要 反复 用 到 的 验证 规则 提取 出 来 单 
独 保存 为 一 个 文件 。 以 后 ， 每 当 需 要 使 用 那些 验证 规则 时 ， 只 需 引 用 这 个 文件 即 可 。 在 下 面 的 
例子 里 ， 针 对 Address 类 的 验证 规则 将 被 单独 保存 到 一 个 Address-validation.xml 文件 里 ， 这 使 
得 Customer-validation.xml 文件 可 以 这 样 。 
<field name="address"> 
<!-- 使 用 visitor 验证 程序 --> 
<field-validator type="visitor"> 
<message>Address:</message> 


</field-validator> 
</field> 


其 中 ， 这 个 field 元 素 的 含义 是 : address 属性 将 使 用 相关 属性 类 型 (Address) 的 验证 配置 文 
件 来 进行 验证 。 换 句 话说 ，Struts 2 将 使 用 Address-validation.xml 文件 来 验证 address 属性 。 这 
样 一 来 ， 即 使 有 多 个 动作 类 都 是 用 到 了 Address， 也 不 必 在 每 个 动作 类 的 每 个 验证 程序 配置 文 
件 里 写 出 同样 的 验证 规则 。 

Visitor(VisitorFieldValidator 验证 器 ) 验 证 程序 的 另 一 个 功能 是 可 以 引用 上 下 文 。 如 果 有 多 个 
使 用 了 Address 的 动作 ， 但 其 中 有 一 个 需要 使 用 的 验证 规则 与 Address-validation xml 文件 所 给 
出 的 不 一 样 ， 可 以 只 为 那个 动作 创建 一 个 新 的 验证 程序 配置 文件 。 这 种 验证 程序 配置 文件 的 命 
名 规则 如 下 所 示 。 
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Address-context-validation.xml 


其 中 的 context 是 需要 为 Address 类 另行 定义 验证 规则 的 动作 的 别名 。 例 如 ， 如 果 
AddEmployee 动作 的 address 属性 需要 用 与 众 不 同 的 规则 来 进行 验证 ， 将 需要 创建 这 个 文件 。 


Address-AddEmployee-validation.xml 


到 此 还 未 结束 。 如 果 上 下 文 的 名 字 与 动作 别名 不 一 样 一 一 不 妨 假设 AddManager 动作 也 需 
要 使 用 Address-AddEmployee-validation.xml 文件 里 的 规则 ， 而 不 是 使 用 Address- validation.xml 
文件 里 的 规则 来 进行 验证 。 可 以 通过 下 面 这 样 的 field 元 素来 告诉 visitor 验证 程序 需要 使 用 另 
-种 上 下 文 。 
<field name="address"> 
<!-- 使 用 visitor 验证 程序 --> 
<field-validator type="visitor"> 
<!-- 配 置 context 参数 --> 
<param name="context">specific</param> 
<message>Address:</message> 
</field-validator> 
</field> 


这 向 visitor 验证 程序 表明 : 在 验证 address 属性 时 ， 它 应 该 使 用 Address-specific-validation. 
xml 文件 而 不 是 Address-AddManager-validation.xml 文件 。 


6.5.2 ”实例 描述 


最 近 项 目 组 做 了 一 个 会 员 系统 ， 即 如 果 注 册 为 我 们 公司 网 站 的 会 员 ， 可 以 享受 购买 商品 
折 的 优惠 。 因 为 注册 的 用 户 越 来 越 多 ， 当 然 也 有 “ 潍 午 充 数 ” 的 人 ， 填 的 信息 是 乱七八糟 ， 让 
公司 的 “后 勤 ” 人 员 看 的 是 “眼花 综 乱 ”。 于 是 项 目 组 的 人 及 时 对 这 个 会 员 系 统 进行 维护 ， 验 
证 用 户 输入 信息 ， 如 果 填 的 不 符合 要 求 就 不 能 成 为 公司 的 会 员 。 

在 做 的 过 程 中 用 到 了 一 个 Address 类 ， 这 个 类 记录 了 用 户 的 联系 方式 ， 而 在 已 经 做 好 的 公 
司 员工 信息 中 已 经 用 到 了 这 个 类 ， 当 然 也 用 到 了 它 的 Address-validation.xml 验证 规则 文件 ， 不 
能 有 宛 余 的 文件 存在 啊 ! 怎么 办 ? 灵机 一 动 ， 对 ， 就 用 VisitorFieldValidator 验证 器 来 对 注册 会 
员 进行 联系 方式 验证 …… 


6.5.3 ”实例 应 用 


【 例 6-5】 注册 会 员 。 

(1) 在 com.struts2.model 包 下 创建 Address 实体 类 ， 记 载 用 户 的 一 些 联 系 方式 信息 ， 代 码 
如 下 。 

Package com.struts2.model; 

/太太 

* 联 系 方式 类 


*@author Administrator 
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这 
public class Address { 
private String streetName;// 街 道 名 称 
private String streetNumber;// 门 牌号 
private String city;// 城 市 
private String state;// 国 家 
private String zipCode;// 邮 政 编 码 
/* 下 面 是 上 面 所 有 属性 的 get 、set 方法 ， 这 里 省 略 */ 
i 


(2) 继续 在 com.struts2.model 包 下 创建 Address 类 的 验证 规则 文件 Address-validation.xml。 
对 Address 类 中 所 有 的 属性 配置 相关 的 校 验 器 ， 对 其 进行 输入 校 验 ， 验 证 内 容 如 下 。 


<validators> 
<!-- 为 Address 类 中 的 streetName 属性 配置 必 填 校 验 器 --> 
<field name="streetName"> 
<field-validator type="requiredstring"> 
<message> 街 道 名 称 不 能 是 空 的 ! </message> 
</field-validator> 
</field> 
<!-- 为 Address 类 中 的 streetNumber 属性 配置 必 填 校 验 器 --> 
<field name="streetNumber"> 
<field-validator type="requiredstring"> 
<message> 街 道 号 码 不 能 为 空 ! </message> 
</field-validator> 
</field> 
<!-- 为 Address 类 中 的 city 属性 配置 必 填 校 验 器 --> 
<field name="city"> 
<field-validator type="requiredstring"> 
<message> 城 市 不 能 为 空 ! </message> 
</field-validator> 
</field> 
<!-- 为 Address 类 中 的 state 属性 配置 必 填 校 验 器 --> 
<field name="state"> 
<field-validator type="requiredstring"> 
<message> 国 家 不 能 为 空 ! </message> 
</field-validator> 
</field> 
<!-- 为 Address 类 中 的 zipcode 属性 配置 必 填 校 验 器 --> 
<field name="zipCode"> 
<field-validator type="requiredstring"> 
<message> 邮 政 编码 不 能 为 空 ! </message> 
</field-validator> 
</field> 
</validators> 


(3) 在 com.struts2.actions 包 下 创建 Customer 类 ， 继 承 自 com.opensymphony.xwork2. 
ActionSupport， 并 重 写 父 类 的 execute0 方 法 ， 转 入 成 功 页 面 。 代 码 如 下 。 


package com.struts2.actions; 


< 委 —— 
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import com.opensymphony .xwork2.ActionSupport; 
import com.struts2.model.Address; 

/太太 

* 客 户 Rction 


*Q@author Rdministrator 
四 


区 
public class Customer extends Actionsupport { 
private String name; 
private Address address; 
@Override 
public String execute () throws Exception { 
return SUCCESS; 
} 


/* 下 面 是 上 面 name、Address 对 象 address 属性 的 get、set 方法 ， 这 里 省 略 */ 
y 


(4) 继续 在 com.struts2.actions 包 下 新 创建 Customer 类 的 验证 规则 文件 Customer- 
validation.xml， 对 Customer 的 属性 name、Address 对 象 address 进行 输入 校 验 。 校 验 内 容 如 下 。 


<validators> 
<field name="name"> 
<!-- 为 customer 类 中 的 name 属性 配置 必 填 校 验 器 --> 
<field-validator type="requiredstring"> 
<message> 姓 名 不 能 为 空 ! </message> 
</field-validator> 
</field> 
<!-- 使 用 visitor 验证 程序 --> 
<field name="address"> 
<field-validator type="visitor"> 
<!-- 为 VisitorFieldValidator 校 验 器 配置 context 参数 , 指定 在 验证 address 
属性 时 ， 它 应 该 使 用 Address-specific-validation.xml 文件 --> 
<param name="context">specific</param> 
<message>Address:</message> 
</field-validator> 
</field> 
</validators> 


(5) 对 邮政 编码 的 验证 除了 非 空 之 外 还 必须 是 有 效 的 格式 ， 而 在 Address-validation.xml 文 
件 中 只 进行 了 非 空 验证 ， 并 没有 进行 格式 验证 ， 因 此 需要 在 Address 类 所 在 的 包 com.struts2. 
model 下 创建 Address-specific-validation.xml 校 验 规则 文件 , 对 用 户 输入 的 邮政 编码 进行 表达 式 
验证 。 表 达 式 校 验 器 内 容 如 下 。 

<validators> 


<!-- 为 address 类 中 的 zipcode 属性 配置 表达 式 校 验 器 --> 
<field name="zipCode"> 
<field-validator type="regex"> 
<param name="expression"> 
<![cDpaATA[\d\d\d\d\d\gd]]> 
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</param> 
<message> 邮 政 编号 必须 有 效 ! </message> 
</field-validator> 
</field> 
</validators> 


(6) 在 struts-config 文件 夹 下 创建 customer.xml 文件 ， 配 置 Customer 类 。 配 置 如 下 。 


<package name ="customer" extends ="struts-default" > 
<!-- 配置 一 个 名 为 customer 的 Action--> 
<action name ="customer" class ="com.struts2.actions.Customer" > 
<result name="input">/customer.jsp</result> 
<result name="success">/success.jsp</result> 
</action> 
</package> 


(7) 把 customer.xml 文件 引入 struts.xml 文件 当中 。 
(8) 创建 会 员 注 册页 面 customerjsp， 代 码 如 下 。 


<s:form action="customer.action" method="post"> 
<s:textfield name="name"” label=" 姓 名 " /> 
<s:textfield name="address.streetName"” label=" 街 道 名 称 "/> 
<s:textfield name="address.streetNumber" label=" 门 牌号 " /> 
<s:textfield name="address.city"” label=" 城 市 "/> 
<s:textfield name="address.state" label=" 国 家 "/> 
<s:textfield name="address.zipcode"” label=" 邮 政 编码 "/> 
<s:submit value=" 确 定 "/> 


</s:form> 


运行 customerjsp 页 面 ， 单 击 “ 确 定 ” 按 钮 ， 提 交 表 单 ， 提 示 错 误 信 息 ， 如 图 6-13 所 示 。 


用 户 信息 录入 


图 6-13 输入 为 空 时 提示 错误 信息 


< 
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当 输 入 所 有 信息 , 但 邮政 编码 不 为 6 位 数字 时 ,提示 “邮政 编码 必须 有 效 ! ”的 错误 信息 ， 
如 图 6-14 所 示 。 


6-14 ”邮政 编码 无 效 时 提示 错误 信息 


6.5.5 ”实例 分 析 


a 


在 上 案例 中 ，Customer 动作 类 中 有 一 个 Address 类 型 的 address 属性 , 而 这 个 Address 类 所 
在 的 包 为 com.struts2.model， 因 此 需要 在 com.struts2.model 包 下 创建 Address 类 的 校 验 规则 文 
件 Address-validation.xml。 

在 对 Customer 类 中 的 属性 address 进行 校 验 时 ， 使 用 了 visitor 验证 程序 ， 并 配置 了 它 的 
context 参数 值 为 specific， 这 就 说 明 在 验证 address 属性 时 ， 不 仅 要 使 用 Address 类 的 校 验 规则 
文件 Address-validation.xml， 还 需要 使 用 Address-specific-validation.xml 文件 。 因 为 使 用 visitor 
验证 程序 时 ， 是 对 Customer 类 中 的 属性 address 进行 校 验 ,因此 Address-specific-validation.xml 
文件 也 需要 放置 在 com.struts2.model 包 下 。 


6.6 使 用 验证 注解 


除了 提供 编写 验证 文件 之 外 ，Struts 2 还 提供 了 使 用 注解 的 方式 来 定义 验证 规则 。 下 面 就 
来 介绍 一 下 可 以 使 用 哪些 注解 来 对 输入 数据 进行 校 验 。 


多 
时? 视频 教学 : 光盘 /videos/06/required.avi 全 长 度 : 8 分 钟 


6.6.1 基础 知识 使 用 验证 注解 
Struts 2 内 置 的 13 个 验证 器 都 有 对 应 的 注解 ， 下 面 来 看 一 下 Struts 2 中 与 验证 相关 的 注解 


>> 
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都 有 哪些 。 

1. RequiredFieldValidator 注 解 

RequiredFieldValidator 注解 对 应 于 RequiredFieldValidator 验证 器 ， 该 注解 只 能 用 在 方法 级 
别 ， 它 们 的 参数 如 表 6-1 所 示 。 


表 6-1 RequiredFieldValidator 注 解 的 参数 


参 数 描 述 
message | String 验证 失败 时 的 默认 错误 消息 
key | suing 国际 化 资源 文件 中 的 消息 key 

对 于 SIMPLE 验证 类 型 ， 指 定 
fieldName String 


字段 名 
验证 器 是 否 作为 短路 使 用 

验证 类 型 ， 可 选 的 值 为 FIELD 
或 SIMPLE 


shortCircuit | boolean 


type ValidatorType 


© message 参数 用 于 配置 默认 的 错误 消息 ， 如 果 使 用 了 key 参数 ,那么 将 以 国际 化 资 
注意 源 文件 中 配置 的 消息 文本 作为 错误 消息 ; 如 果 在 资源 文件 中 没有 找到 key 对 应 的 
消息 文本 ， 则 使 用 message 参数 给 出 的 错误 消息 。message 参数 也 可 以 单独 使 用 。 
配置 例子 如 下 。 
@RequiredFieldValidator!( 
message=" 用 户 名 不 能 为 空 ! "， 
key="error.username.required", 


shortCircuit=true 


) 


2. RequiredStringValidator 注 解 


RequiredStringValidator 注解 对 应 于 RequiredStringValidator 验证 器 ， 该 注解 只 能 用 在 方法 
级 别 ， 它 的 参数 如 表 6-2 所 示 。 
表 6-2 RequiredStringValidator 注 解 的 参数 


参 数 类 型 描 述 

message String 验证 失败 时 的 默认 错误 消息 

key String 国际 化 资源 文件 中 的 消息 key 

fieldName String 对 于 SIMPLE 验证 类 型 , 指定 字段 名 

shortCircuit | boolean 否 false 验证 器 是 否 作 为 短路 使 用 

type ValidatorType | 否 ValidatorType.FIELD a 
SIMPLE 

pe a 指定 在 进行 是 否 为 空 检查 之 前 , 是 否 
要 删除 字符 串 首尾 的 空格 


< 


配置 例子 如 下 。 


@RequiredstringValidator( 


) 


message=" 邮 箱 地 址 不 能 为 空 ! "， 
key="error.email.required", 
shortCircuit=true, 
trim=true 


3. StringLengthFieldValidator 注 解 
StringLengthFieldValidator 注解 对 应 于 StringLengthFieldValidator 验证 器 ,该 注解 只 能 用 在 


方法 级 别 ， 


参 数 


message 


key 


fieldName 
shortCircuit 


type 


minLength 


maxLength 


它 的 参数 如 表 6-3 所 示 。 


表 6-3 StringLengthFieldValidator 注 解 的 参数 


类 型 描 述 
String FE 验证 失败 时 的 默认 错误 消息 
String 无 
ke 
定 字段 名 
和 一 一 验证 器 是 否 作为 短路 使 用 
FIELD 或 SIMPLE 
指定 在 进行 是 否 为 空 检查 之 
boolean 否 前 ， 是 否 要 删除 字符 串 首尾 
的 空格 
String | 否 | 无 | 指定 字符 申 的 最 小 长 度 
Sting | 否 | 无 | 指定 字符 申 的 最 大 长 度 


配置 例子 如 下 。 


@stringLengthFieldValidator( 


) 


message=" 用 户 名 必须 在 ${minLength} 和 $ {maxLength} 之 间 ! "， 
key="error.username.length", 

ShortCircuit=truey 

trim=true, 

minLength="4", 

maxLength="12" 


4. IntRangeFieldValidator 注 解 
IntRangeFieldValidator 注解 对 应 于 IntRangeFieldValidator 验证 器 ， 该 注解 只 能 用 在 方法 级 
别 ， 它 的 参数 如 表 6-4 所 示 。 


ER >> 


第 6 章 探索 数据 校 验 的 奥妙 


表 6-4 IntRangeFieldValidator 注 解 的 参数 


Imessage String 是 无 验证 失败 时 的 默认 错误 消息 

key String 否 无 国际 化 资源 文件 中 的 消息 key 

Re Se 寺 对 于 SIMPLE 验证 类 型 , 指定 

字段 名 

shortCircuit | boolean 否 验证 器 是 否 作为 短路 使 用 
验证 类 型 , 可 选 的 值 为 FIELD 

type ValidatorType 否 ValidatorType.FIELD 吉 L IN 

min String 否 无 指定 整数 的 最 小 值 

max String 否 无 指定 整数 的 最 大 值 


配置 例子 如 下 。 


QIntRangeEieldValidator( 


message=" 年 龄 必须 在 S{min} 和 $fmax} 之 间 ! "v 


key="error.age", 
shortCircuit=true, 


min="20", 
max="50" 


) 


5. DoubleRangeFieldValidator 注 解 


DoubleRangeFieldValidator 注解 对 应 于 DoubleRangeFieldValidator 验证 器 ， 该 注解 只 能 用 


在 方法 级 别 ， 它 的 参数 如 表 6-5 所 示 。 


表 6-5 ”DoubleRangeFieldValidator 注 解 的 参数 


参 数 类 型 默认 值 描 述 
message String 无 验证 失败 时 的 默认 错误 消息 
key String 无 国际 化 资源 文件 中 的 消息 key 
fieldName String 无 对 于 SIMPLE 验证 类 型 , 指定 字段 名 
shortCircuit boolean false 验证 器 是 否 作 为 短路 使 用 
验证 类 型 ， 可 选 的 值 为 FIELD 或 
type ValidatorType ValidatorType.FIELD 


SIMPLE 


minInclusive String 


maxInclusive String 


指定 双 精 度 浮 点 数 可 包含 的 最 小 值 
指定 双 精 度 浮 点 数 可 包含 的 最 大 值 


minExclusive | String 


maxExclusive | String 


指定 双 精 度 浮 点 数 必须 大 于 的 
最 小 值 
指定 双 精 度 浮 点 数 必须 小 于 的 
最 大 值 


< 告 一 


人 ts Deo 下 2 交 二 


如 果 没 有 指定 最 小 值 和 最 大 值 ， 那 么 DoubleRangeFieldValidator 验证 器 将 什么 也 不 做 。 配 
置 例 子 如 下 。 


@DoubleRangeFieldValidator!( 
message=" 价 格 必须 在 $ {minInclusive} 和 $ {maxInclusive]} 之 间 ! "， 
key="error.price"™, 
shortCircuit=true, 
minInclusive="20.1"™, 
maxInclusive="50.1" 


) 


6. DateRangeFieldValidator 注 解 


DateRangeFieldValidator 注解 对 应 于 DateRangeFieldValidator 验证 器 ， 该 注解 只 能 用 在 方 
法 级 别 ， 它 的 参数 如 表 6-6 所 示 。 
表 6-6 DateRangeFieldValidator 注 解 的 参数 


参 数 类 型 是 否 必需 默认 值 描述 
message Stuing | 是 | 无 验证 失败 时 的 默认 错误 消息 
_ _ 国际 化 资源 文件 中 的 消息 
key String 否 无 
ke 
fieldName String 无 人 
定 字段 名 
shortCircuit boolean false 验证 器 是 否 作为 短路 使 用 
验证 类 型 ,可 选 的 值 为 FIELD 
type ValidatorType ValidatorType.FIELD 或 SIMPLE 
minInclusive | String 无 人 ea 
最 小 值 
maxInclusive String elo 
最 大 值 
minExclusive | String 人 
的 最 小 值 
maxExclusive | String 人 
的 最 大 值 


配置 例子 如 下 。 


@DateRangeFieldValidator( 
message=" 出 生日 期 必须 在 $ {min} 和 $ {max} 之 间 ! "， 
key="error.birthday", 
shortCircuit=true, 
min="1990/01/01", 
max="2011/01/01" 
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7. ExpressionValidator 注 解 


ExpressionValidator 注解 对 应 于 ExpressionValidator 验证 器 , 该 注解 只 能 用 在 方法 级 别 , 它 
的 参数 如 表 6-7 所 示 。 


表 6-7 ExpressionValidator 注 解 的 参数 


是 无 验证 失败 时 的 默认 错误 消息 
key String 否 无 国际 化 资源 文件 中 的 消息 key 
shortCircuit | boolean 验证 器 是 否 作 为 短路 使 用 


expression String 指定 一 个 返回 布尔 值 的 OGNL 表达 式 


配置 例子 如 下 。 


QExpressionValidator( 
message=" 两 次 输入 的 密码 必须 一 致 ! "， 


key="error.verifyPassword.identical", 


shortCircuit=true, 
expression="user.password==verifyPassword" 


) 


8. FieldExpressionValidator 注 解 


FieldExpressionValidator 注解 对 应 于 FieldExpressionValidator 验证 器 ， 该 注解 只 能 用 在 方 
法 级 别 ， 它 的 参数 如 表 6-8 所 示 。 
表 6-8 FieldExpressionValidator 注 解 的 参数 


参数 | 类 型 | 是 必需 | 描 述 
EE 


message 验证 失败 时 的 默认 错误 消息 

key 国际 化 资源 文件 中 的 消息 key 
fieldName 对 于 SIMPLE 验证 类 型 ， 指 定 字段 名 
he | i ; 验证 器 是 否 作为 短路 使 用 

expression ing 指定 一 个 返回 布尔 值 的 OGNL 表达 式 


配置 例子 如 下 。 


@FieldExpressionValidator( 
fieldName="verifyPassword", 
expression="user.password.equals (verifyPassword)", 
key="error.verifyPassword.identical", 
message=" 两 次 输入 的 密码 必须 相同 ! " 

) 


9. RegexFieldValidator 注 解 
RegexFieldValidator 注解 对 应 于 RegexFieldValidator 验证 器 ， 该 注解 只 能 用 在 方法 级 别 ， 


怀 全 mm 
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它 的 参数 如 表 6-9 所 示 。 
表 6-9 RegexFieldValidator 注 解 的 参数 
参 数 类 型 是 否 必需 描述 
message String 是 验证 失败 时 的 默认 错误 消息 
key String 否 国际 化 资源 文件 中 的 消息 key 
ee SEE 否 对 于 SIMPLE 验证 类 型 ， 指 定 
字段 名 

shortCircuit boolean 否 验证 器 是 否 作 为 短路 使 用 

| 验证 类 型 ， 可 选 的 值 为 FIELD 
type ValidatorType 得 A 
expression Strin: 是 用 于 验证 字段 值 的 正则 表达 式 


配置 例子 如 下 。 


QRegexFieldValidator( 
message=" 不 是 有 效 的 邮政 编码 ! "， 
key="regex.field", 
expression="<! [CDATA[[0-9] \d{5} (?!1\d)]]>" 
) 


10. EmailValidator 注 解 
EmailValidator 注解 对 应 于 EmailValidator 验证 器 ,该 注解 只 能 用 在 方法 级 别 ， 它 的 参数 如 
表 6-10 所 示 。 
表 6-10 ”EmailValidator 注 解 的 参数 


参 数 类 型 默认 值 描 述 
message Strin 无 验证 失败 时 的 默认 错误 消息 
key String 无 国际 化 资源 文件 中 的 消息 key 
fieldName String 无 和 人 
字段 名 

ShortCircuit boolean false 验证 器 是 否 作为 短路 使 用 

验证 类 型 ， 可 选 的 值 为 FIELD 
type ValidatorType ValidatorType.FIELD 或 SIMPLE 


配置 例子 如 下 。 


@EmailValidator( 
key="error.email.invalid", 
type=ValidatorType.FIELD, 
message=" 邮 箱 地 址 必须 是 有 效 的 ! " 


mm >> 
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11. UrlValidator 注 解 
UrlValidator 注解 对 应 于 UrlValidator 验证 器 ,该 注解 只 能 用 在 方法 级 别 , 它 的 参数 如 表 6-11 
所 示 。 


表 6-11 UrlValidator 注 解 的 参数 


描 述 
验证 失败 时 的 默认 错误 消息 


key String 否 国际 化 资源 文件 中 的 消息 key 
fieldName | String | 否 对 于 SIMPLE 验证 类 型 ， 指 定 字段 名 
shortCircuit | boolean | 否 false 验证 器 是 否 作为 短路 使 用 

验证 类 型 ， 可 选 的 值 为 FIELD 或 
type ValidatorType | 否 ValidatorType.FIELD 


SIMPLE 


配置 例子 如 下 。 


QUrlValidator( 
message=" 链 接地 址 必须 是 有 效 的 ! "， 
key="error.url", 
shortCircuit=true 


) 


12. VisitorFieldValidator 注 解 
VisitorFieldValidator 注解 对 应 于 VisitorFieldValidator 验证 器 ， 该 注解 只 能 用 在 方法 即 被 ， 
它 的 参数 如 表 6-12 所 示 。 
表 6-12 ”VisitorFieldValidator 注 解 的 参数 


| 类 型 | 是 必需 | 默认 值 | 


是 无 
否 无 
否 无 


message 验证 失败 时 的 默认 错误 消息 
key 国际 化 资源 文件 中 的 消息 key 


对 于 SIMPLE 验证 类 型 ， 指 定 字段 名 
验证 器 是 否 作为 短路 使 用 
指定 验证 发 生 的 上 下 文 
指定 要 添加 到 字段 上 的 前 级 


fieldName 


shortCircuit 


Context | String 
appendPrefix 


配置 例子 如 下 。 


QQVisitorFieldValidator( 
message="User:", 
shortCircuit=true, 
context="login", 


appendPrefix=true 


< 沼 一 
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13. ConversionErrorFieldValidator 注 解 
ConversionErrorFieldValidator 注解 对 应 于 ConversionErrorFieldValidator 验证 器 ， 该 注解 只 


能 用 在 方法 级 别 ， 它 的 参数 如 表 6-13 所 示 。 
表 6-13 ”ConversionErrorFieldValidator 注 解 的 参数 


验证 失败 时 的 默认 错误 消息 


key String 国际 化 资源 文件 中 的 消息 key 
fieldName | String 对 于 SIMPLE 验证 类 型 ， 指 定 字段 名 
shortCircuit | boolean false 验证 器 是 否 作为 短路 使 用 


验证 类 型 ， 可 选 的 值 为 FIELD 或 
SIMPLE 


type ValidatorType ValidatorType.FIELD 


配置 例子 如 下 。 


@ConversionErrorFieldValidator( 
message=" 类 型 转换 失败 ! "， 
key="il8n.key", 
shortCircuit=true 


) 


14. CustomValidator 注 解 


CustomValidator 注解 用 于 自 定义 验证 器 , 通过 ValidationParameter 注解 向 自 定义 验证 器 提 
供 参数 。CustomValidator 注解 可 以 用 在 方法 或 者 类 型 级 别 ， 它 的 参数 如 表 6-14 所 示 。 


表 6-14 CustomValidator 注 解 的 参数 


默认 值 描 述 
是 9 指定 已 注册 的 验证 器 的 名 字 
messape String 是 验证 失败 时 的 默认 错误 消息 
key | Biing 否 际 化 资源 文件 中 的 消息 key 
fieldName String 否 对 于 SIMPLE 验证 类 型 , 指定 字段 名 
shoniCienit | boolean 否 验证 器 是 否 作为 短路 使 用 
ValidationParameter 否 无 为 自 定 义 验证 器 提供 参数 


配置 例子 如 下 。 


QcustomValidator ( 
type="validationCodeValidator", 
fieldName="validationCode", 
key="error.validationCode.invalid", 
message=" 验 证 字段 必须 是 有 效 的 ! "， 
parameters= 


@VvalidationParameter( 
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name="sessionValidationCode", 
value="#session.validationCode" 


) 


15. ValidationParameter 注 解 


ValidationParameter 注解 用 于 为 自 定义 验证 器 提供 参数 , 该 注解 必须 在 CustomValidator 注解 
内 部 使 用 ， 作 为 parameters 参数 的 元 素 值 使 用 。ValidationParameter 注解 的 参数 如 表 6-15 所 示 。 


表 6-15 ValidationParameter 注 解 的 参数 


name 


Value 


16. Validations 注 解 


如 果 想 要 在 一 个 方法 上 使 用 相同 类 型 的 多 个 注解 , 那么 必须 将 它们 放 到 @Validations0 注 解 
的 内 部 使 用 。Validations 注解 只 能 用 在 方法 级 别 ， 它 的 参数 如 表 6-16 所 示 。 


表 6-16 Validations 注 解 的 参数 
参 数 类 型 | 是 否 必需 | 默 认 什 描述 


RequiredFieldValidator 注解 的 
数组 


CustomValidator 注解 的 数组 


ionEmrorFields | c | 无 ConversionErrorFieldValidator 
conversionErrorFields | ConversionErrorFieldValidator| | 
注解 的 数组 
答 
否 


requiredFields RequiredFieldValidator[] 


customValidators CustomValidator 


DateRangeFieldValidator 注解 的 


dateRangeFields DateRangeFieldValidator[] 无 数组 
emails EmailValidator| 无 EmailValidator 注解 的 数组 
fieldExpression FieldExpressionValidatol EmailValidator 注解 的 数组 

IntRangeFieldValidator 注解 的 
intRangeFields JIntRangeFieldValidator[] 无 数组 

RequiredStringValidator 注解 的 

requiredStrings RequiredStringValidator[] 否 无 数组 

StringLengthFieldValidator 注解 
stringLengthFields StringLengthFieldValidator[] 否 无 的 数组 
urls UrlIValidator| UrlValidator 注解 的 数组 
VisitorFields VisitorFieldValidator[] 竺 无 VisitorFieldValidator 注解 的 数组 
regexFields RegexFieldValidator[] 否 无 RegexFieldValidator 注解 的 数组 
expression ExpressionValidatol 否 无 ExpressionValidator 注解 的 数组 


< 和 
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配置 例子 如 下 。 


@Vvalidations( 
requiredstrings= 
BRequiredStringValidator( 
type=ValidatorType.SIMPLE, 
fieldName="verifyPassword", 
message=" 确 认 密码 不 能 为 空 ! "， 


key="error.verifyPassword.required" 


), 

@RequiredstringValidator( 
type=ValidatorType.SsIMPLE, 
fieldName="validationCode", 
key="error.validationCode.required", 


message=" 验 证 字段 不 能 为 空 ! " 


}, 
fieldExpressions= 
{ 
Q@FieldExpressionValidator!( 
fieldName="verifyPassword", 


expression="user.password.equals (VerifyPassword)"， 
key="error.verifyPassword.identical", 


message=" 两 次 输入 的 密码 必须 一 致 ! " 


]} 
customValidators= 
{ 
@CustomValidator( 
type="validationCodeValidator", 
fieldName="validationCode", 
key="error.validationCode.invalid", 
message=" 验 证 字段 必须 是 有 效 的 ! "， 
parameters= 
{ 
@ValidationParameter( 
name="sessionValidationCode", 
value="#session.validation Code" 


17. Validation 注 解 


使 用 Validation 注解 ,可 以 在 类 或 者 接口 上 配置 验证 规则 。Validation 注解 只 能 用 在 类 型 级 
别 ， 它 的 参数 如 表 6-17 所 示 。 


mm >> 


参 数 
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表 6-17 Validation 注 解 的 参数 


描 述 


validations 


配置 例子 如 下 。 


@Validations( 
requiredstrings= 


Wo 


{ 


用 于 类 或 接口 的 验证 规则 


@RequiredstringValidator!( 


) ， 


type=ValidatorType-SIMPLE， 
fieldName="verifyPassword", 
message=" 请 再 次 输入 密码 ! "， 


key="error.verifyPassword.required" 


@RequiredstringValidator!( 


type=ValidatorType.SIMPLE, 
fieldName="validationCode", 
key="error.validationCode.required", 


message=" 验 证 字段 不 能 是 空 的 ! " 


fieldExpressions= 


{ 


}, 


@FieldExpressionValidator( 


fieldName="verifyPassword", 
expression="user.password.equals (verifyPassword)", 
key="error.verifyPassword.identical", 


message=" 两 次 输入 的 密码 必须 一 致 ! " 


customValidators= 


@CustomValidator( 


type="validationCodeValidator", 

fieldName="validationCode", 

key="error.validationCode.invalid", 

message=" 验 证 字段 必须 是 有 效 的 ! "， 

parameters= 

{ 

@ValidationParameter( 

name="sessionValidationCode", 
value="#session.validation Code" 


< 
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Struts 2 的 文档 对 Validation 注解 的 说 明 是 : “如 果 想 要 使 用 基于 注解 的 验证 ， 必 
须 使 用 Validation 注解 标注 类 或 者 接口 ”， 但 经 过 测试 ， 即 使 不 使 用 Validation 注 
解 ， 只 使 用 其 他 注解 配置 的 验证 规则 也 能 正常 地 执行 。 


应 
部 


6.6.2 ”实例 描述 


最 近 一 段 时 间 由 于 公司 业务 繁忙 , 所 以 需要 招 新 人 。 今天 来 了 一 个 应 聘 的 人 , 我 接待 了 他 。 
口头 面试 很 成 功 ， 接 下 来 的 是 笔试 ， 我 想 着 : 这 下 得 来 点 有 难度 的 题 来 考 考 他 ， 免 得 让 他 觉得 
我 们 公司 实力 不 行 。 于 是 ， 我 想到 了 之 前 为 客户 做 的 用 户 注册 功能 ， 让 他 用 注解 的 形式 来 对 用 
户 输入 数据 进行 校 验 ， 看 他 能 力 到 底 是 强 ， 还 是 弱 。 


6.6.3 ”实例 应 用 


【 例 6-6】 使 用 验证 注解 完成 用 户 注册 功能 。 
(1) 在 com.struts2.model 包 下 创建 Register.properties 文件 ， 用 于 配置 国际 化 信息 。 当 用 户 
输入 错误 时 ， 读 取 此 文件 中 的 key 值 ， 获 取 提 示 的 错误 信息 。 内 容 如 下 。 


error.username .required= 您 必须 输入 用 户 名 ! 

error.username .length= 您 输入 的 用 户 名 长 度 必须 在 ${minLength} 到 2${fmaxLength} 之 间 ! 
error.password.requi red= 您 必须 输入 密码 ! 
error.password.1length= 您 输入 的 密码 长 度 必须 在 ${minLength} 到 $ {maxLength} 之 间 ! 
error.email. required= 你 必须 输入 邮箱 地 址 ! 

error.email.invalid= 邮 箱 地 址 无 效 ! 


(2) 继续 在 com.struts2.model 包 下 创建 Register 实体 类 ， 使 用 验证 注解 定义 验证 规则 。 内 
容 如 下 。 

package com.struts2.model; 
import com.opensymphony .xwork2.validator.annotations.EmailValidator; 
import 
com.opensymphony .xwork2.validator.annotations.RequiredstringValidator; 
import 
com.opensymphony .xwork2.validator.annotations.SstringLengthFieldValidator; 
import com.opensymphony .xwork2.validator.annotations.ValidatorType; 
public class Registeri{ 

private String username; // 用 户 名 

private String password;// 密 码 

private String email;// 邮 箱 

private String phone;// 电 话 

private String sex;// 性 别 

public String getUsername() { 

return username; 
} 
/*# 


>> 


* 为 username 属性 配置 必 填 信息 校 验 器 

eh 

@RequiredstringValidator( 
type=ValidatorType.FIELD, 


key="error.username.required", 
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// 添 加 短路 校 验 器 ,否则 如 果 用 户 名 没有 输入 , 会 提示 所 有 对 username 属性 校 验 失败 


的 错误 信息 
shortCircuit=true 
) 
/六 妇 
* 为 username 属性 配置 字符 串 长 度 校 验 器 
@stringLengthFieldValidator( 
type=ValidatorType.FIELD, 
key="error.username.length", 
minLength="4", 
maxLength="12" 
) 
public void setUsername (String username) { 
this.username = username; 
} 
public String getPassword() { 
return password; 
} 
/妇女 
* 为 password 属性 配置 必 填 信息 校 验 器 
区 六 
@RequiredstringValidator( 
type=ValidatorType.FIELD, 
key="error.password.required", 
// 添 加 短路 校 验 器 
shortCircuit=true 
) 
/妇女 
* 为 password 属性 配置 字符 串 长 度 校 验 器 
wy 
@stringLengthFieldValidator( 
type=ValidatorType.FIELD, 
key="error.password.length", 
minLength="4", 
maxLength="8" 
) 
public void setPassword(String password) { 
this.password = password; 
} 
public String getEmail() { 
return email; 


/*# 


怀 人 mm 
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* 为 邮箱 地 址 配置 必 填 信 息 校 验 器 
* @param email 
-Wh 
@RequiredstringValidator( 
type=ValidatorType.FIELD, 
key="error.email.required", 
// 添 加 短路 校 验 器 
shortCircuit=true 
) 
/*# 
* 为 邮箱 地 址 配置 邮箱 格式 校 验 器 
ey 
@EmailVvalidator( 
key="error.email.invalid", 
type=ValidatorType.FIELD 
) 
public void setEmail (String email) { 
this.email = email; 


} 
/* 下 面 是 上 面 phone、sex 两 个 属性 的 set、get 方法 ， 这 里 省 略 */ 


4 在 这 里 要 提醒 读者 的 是 : 验证 注解 在 getter 或 者 setter 方法 上 使 用 都 可 以 。 
在 上 面 的 代码 中 ， 提 到 了 一 个 新 的 知识 点 一 一 短路 校 验 器 。 短 路 校 验 器 非常 有 用 ， 读 者 可 
以 把 上 面 配置 的 shortCircuit=tmue 去 掉 试 试 ， 当 在 用 户 名 输入 框 中 没有 输入 任何 内 容 时 ， 会 提 
示 两 条 错误 信息 , 分 别 是 “您 必须 输入 用 户 名 ! ”和 “您 输入 的 用 户 名 长 度 必须 在 $ {minLength} 
到 2${fmaxLength} 之 间 ! ”， 这 样 是 不 是 很 不 友好 啊 ! 
对 于 同一 个 字段 内 的 多 个 校 验 器 ， 如 果 一 个 短路 校 验 器 校 验 失败 后 ， 其 他 校 验 器 都 根本 不 
(3) 在 com.struts2.actions 包 下 新 建 RegisterAction.properties 文件 ， 内 容 如 下 。 
error.verifyPassword.required= 请 输入 确认 密码 ! 
error.verifyPassword.identical= 两 次 输入 的 密码 必须 一 致 ! 


(4) 继续 在 com.struts2.actions 包 下 创建 RegisterAction 类 ， 其 内 部 有 一 个 确认 密码 属性 
verifyPassword 和 Register 实体 类 对 象 属性 reg， 并 对 这 两 个 属性 进行 了 注解 验证 。 具 体 代 码 
如 下 。 


package com.struts2.actions; 
import com.opensymphony .xwork2.ActionSupport; 


import 

com.opensymphony .xwork2.validator.annotations.FieldExpressionValidator; 
import 

com.opensymphony .xwork2 .validator.annotations.RequiredstringValidator; 
import com.opensymphony .xwork2.validator.annotations.Validations; 


import com.opensymphony .xwork2.validator.annotations.ValidatorType; 
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import com.opensymphony.xwork2.validator.annotations.VisitorFieldValidator; 
import com.struts2.model.Register; 
public class RegisterAction extends Actionsupport { 

private Register reg;// 注 册 者 实体 类 对 象 

private String verifyPassword; // 确 认 密 码 

@Vvalidations( 


requiredstrings= 
{ 
/** 
* 为 RegisterAction 类 中 的 verifyPassword 属性 配置 了 必 填 字符 串 
校 验 器 


BRequiredStringValidator ( 
type=ValidatorType.SIMPLE, 
fieldName="verifyPassword", 
key="error.verifyPassword.required" 


}, 
fieldExpressions= 
{ 
/** 
为 RegisterAction 类 中 的 verifyPassword 属 性 配置 了 表达 式 校 验 器 
yh 
Q@FieldExpressionValidator!( 
fieldName="verifyPassword", 


expression="reg.password.equals (verifyPassword)", 
key="error.verifyPassword.identical" 


) 

@Override 

public String execute() throws Exception { 
return SUCCESS; 

} 

public Register getReg() { 
return reg; 

} 

// 为 Register 类 对 象 reg 配置 visitor 校 验 器 

eVisitorFieldValidator (message=" 提 示 :") 

public void setReg (Register reg) { 
this.reg = reg; 

} 

/* 下 面 是 上 面 verifyPassword 属性 的 set、get 方法 ， 这 里 省 略 */ 


(5) 在 struts-config 文件 夹 下 创建 register.xml 文件 ， 配 置 RegisterAction 类 。 配 置 如 下 。 


<package name ="register" extends ="struts-defaultn > 
<!-- 配置 一 个 名 为 customer 的 Action--> 


<action name ="register" class ="com.struts2.actions.RegisterAction" > 


怀 全 mm 


<result name="input">/register.jsp</result> 
<result name="success">/success.jsp</result> 
</action> 
</package> 


(6) 把 配置 好 的 register.xml 文件 引用 至 struts.xml 文件 中 。 
(7) 编辑 注册 页 面 register.jsp 页 面 ， 提 交 转 至 RegisterAction 类 中 execute0 方 法 所 指向 的 
结果 页 面 。registerjsp 页 面 表单 内 容 如 下 。 


<s:form action="register/register.action" method="post" > 
<s:textfield name="reg.username"” label=" 用 户 名 "/> 
<s:password name="reg.password"” label=" 密 码 "/> 
<s:password name="verifyPassword"” label=" 确 认 密 码 "/> 
<s:textfield name="reg.email"” label=" 邮 箱 "/> 
<s:radio list="%{#{' 男 ':' 男 ', ' 女 ':' 女 '}}" name="reg.sex" 
label=" 性 别 "/> 
<s:textfield name="reg.phone"” label=" 电 话 "/> 
<s:submit value=" 注 册 "/> 
</s:form> 


6.6.4 ”运行 结果 


运行 registerjsp 页 面 ， 当 用 户 输入 有 误 时 ， 提 示 错 误 信息 ， 如 图 6-15 所 示 。 


6-15 ”注册 提示 错误 信息 


6.6.5 ”实例 分 析 


Cn 


在 上 案例 中 的 RegisterAction 类 中 ， 在 execute() 方 法 上 使 用 了 Validations 注解 ， 集 中 配置 
验证 规则 ， 并 通过 各 个 验证 注解 的 fieldName 参数 指出 要 验证 的 字段 ， 这 使 得 在 执行 
RegisterAction 类 中 的 execute() 方 法 时 会 对 输入 的 数据 进行 校 验 。 


> >> 


第 6 章 探索 数据 校 验 的 奥妙 呈 


6.7 ”常见 问题 解答 


6.7.1 Struts 2.1.8 版 本 是 否 支持 客户 端 校 验 


Struts 2.1.8 版 本 支持 客户 端 校 验 吗 ? 
网 络 课堂 : http://bbs.itzen.com/thread-11009-1-1.html 


问 : Struts 2.1.8 版 本 支持 客户 端 校 验 吗 ? 如果 该 版 本 支持 客户 端 校 验 ， 到 底 与 Struts 2.1.6 
版 本 有 什么 配置 上 的 差别 呢 ? 

答 : 这 是 很 多 人 想 知道 的 问题 ! 我 刚刚 验证 了 一 下 : Struts 2.1.8 完全 支持 客户 端 校 验 ， 没 
有 任何 问题 。 

如 果 你 配置 的 Action 所 在 的 package 没有 指定 namespace 属性 ， 那 么 JSP 页 面 中 的 
<s:form ... 亿 标签 无 需 任何 改变 ; 如果 你 配置 的 Action 所 在 的 package 指定 了 namespace 属性 ， 
那么 JSP 页 面 中 的 <s:form .…. 人 > 标签 页 需要 指定 namespace 属性 。 

还 有 一 点 需要 注意 : 不 能 直接 通过 xxx.jsp 页 面 来 使 用 Struts 2 的 客户 端 校 验 ， 而 应 该 通过 

-个 Action 来 跳 转 到 需要 使 用 客户 端 校 验 的 页 面 。 


6.7.2 ” 校 验 器 的 配置 风格 都 有 哪些 ， 它 们 的 校 验 顺序 原则 ， 校 验 器 
短路 的 原则 


校 验 器 的 配置 风格 都 有 哪些 ? 它们 的 校 验 顺序 原则 是 什么 ? 校 验 器 短路 的 原则 是 
什么 ? 
网 络 课堂 : http://bbs.itzen.com/thread-11010-1-1.html 


问 : 在 这 章 一 直 提 到 一 个 词 “ 校 验 器 的 配置 风格 ”， 那 么 校 验 器 的 配置 风格 有 哪些 呢 ? 而 
它们 的 校 验 顺序 原则 是 什么 ? 在 Struts 2 的 内 署 校 验 器 中 不 是 有 一 个 短路 校 验 器 吗 ? 它 的 原则 
是 什么 ? 

答 : Stmts 2 提供 了 两 种 方式 来 配置 校 验 规则 : 字段 校 验 器 风格 和 非 字 段 校 验 器 风格 。 字 
段 校 验 器 配置 风格 一 般 是 以 <field .…./> 元 素 为 基本 子 元 素 ; 非 字段 校 验 器 风格 是 一 种 以 校 验 器 
优先 的 配置 方式 ， 在 这 种 配置 方式 下 ， 校 验 规 则 文件 的 根 元 素 包含 了 多 个 <validator ... 人 > 元素 ， 
每 个 <validator ... 人 元素 定 义 了 一 个 校 验 规则 。 

很 多 时 候 需 要 用 到 短路 校 验 器 时 ， 只 需要 在 <validator ... 人 元素 或 <field-validator ... 人 元 素 
中 增加 short-circuit="true" 即 可 。 


@ 在 Struts 2 的 现 阶段 ， 客 户 端 校 验 还 不 支持 短路 特性 . 
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校 验 器 的 执行 顺序 有 如 下 原则 。 


@ 所 有 非 字段 风格 的 校 验 器 优先 于 字段 风格 的 校 验 器 。 

@ ”所 有 非 字段 风格 的 校 验 器 中 ， 排 在 前 面 的 会 先 执行 。 

@ ”所 有 字段 风格 的 校 验 器 中 ， 排 在 前 面 的 会 先 执行 。 

校 验 器 短路 的 原则 是 。 

@ 所 有 非 字段 校 验 器 是 最 优先 执行 ， 如 果 某 个 非 字段 校 验 器 校 验 失败 了 ， 则 该 字段 上 所 
有 字段 校 验 器 都 不 会 获得 校 验 的 机 会 。 

@ 非 字 段 校 验 器 的 校 验 失败 ， 不 会 阻止 其 他 非 字 段 校 验 的 执行 。 

@ ”如 果 一 个 字段 校 验 器 校 验 失败 后 , 则 该 字段 下 的 且 排 在 该 校 验 失败 的 校 验 器 之 后 的 其 
他 字段 校 验 器 不 会 获得 校 验 的 机 会 。 

@ 字段 校 验 器 永远 都 不 会 阻止 非 字段 校 验 器 的 执行 。 

6.7.3 Struts 2 如 何 显示 验证 出 错 信息 


Stmuts 2 如 何 显示 验证 出 错 信息 ? 
网 络 课堂 : http:Wbbs.itzcn.comy/thread-11012-1-1.html 


在 Struts 2 中 有 如 下 validate0 验 证 方法 。 


public void validate(){ 


if(getUserName () == null |1getUserName () .equals("")){ 
addFieldError ("userNameError", "没有 输入 用 户 名 ") ; 

} 

if(getPassword() == null||lgetPassword() .equals ("")){ 
addFieldError ("passwordError", "没有 输入 密码 ") ; 

} 


问 : 请 在 JSP 页 面 中 , 如 何 从 ValueStack 里 取出 userNameEror? 不 想 用 Stuts 2 的 <s:fieldEmor ../> 
标签 ， 因 为 它 的 样式 太 难 控制 了 ， 如 何 让 它 只 显示 出 错误 信息 userNameError 或 passwordError 
对 应 的 值 呢 ? 

答 : 从 ValueStack( 值 栈 ) 中 取 值 有 两 种 方式 。 


直接 读 取 属 性 名 字 ， 例 <s:property value=“ 属 性 名 ”/>。 
使 用 OGNL 表达 式 ， 例 <s:property value=“%{ 属 性 名 }”/>。 


关于 错误 提示 可 以 从 两 个 属性 中 取得 。 


errors 属性 中 取得 


<s:property value=”%{errors.userNameError}”/> 
<s:property value=”errors.userNameError”/> 


fieldErrors 属性 中 取得 


<s:property value=”%{fieldErrors.userNameError}”/> 


<s:property value=”fieldErrors.userNameError”/> 


痛 
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一 、 填 空 题 
(1) 手动 完成 输入 校 验 有 三 种 方式 可 以 实现 ， 分 别 是 在 Action 的 execute() 方 法 中 进行 校 


、 在 validateXxx( 方 法 中 进行 校 验 和 


(2) Struts 2 针对 常用 的 验证 器 需求 ， 提 供 了 个 验证 器 。 
(3) 如 果 想 要 开发 自己 的 校 验 器 ， 那 么 自 定 义 的 校 验 器 类 必须 实现 接口 。 
(4) 下 面 代码 表明 : 在 验证 user 属性 时 ， 它 应 该 使 用 天 怕 ; 


<field name="user"> 
<!-- 使 用 visitor 验证 程序 --> 
<field-validator type="visitor"> 
<!-- 配 置 context 参数 --> 
<param name="context">cardid</param> 
<message>Address:</message> 
</field-validator> 
</field> 


二 、 选 择 题 
(1) 在 编辑 验证 规则 文件 时 ， 获 取 国 际 化 消息 有 两 种 方式 ， 分 别 是 。 
A. 通过 key 指定 国际 化 提示 信息 
B. 通过 ActionSupport 的 getText() 方 法 获取 国际 化 提示 信息 
C. 通过 value 指定 国际 化 提示 信息 
D. 通过 Validator 的 实现 类 获取 国际 化 提示 信息 
(2) 字符 串 长 度 验证 器 (stringlength validator) 可 以 接受 4 个 参数 ， 分 别 为 
A. fieldName、 min、 max、 trim 
B. fieldName、 min、 max、 shortCircuit 
C. fieldName、 minLength、 maxLength、 shortCircut 
D. fieldName、 minLength、 maxLength、trim 
(3) 下 面 这 段 代 码 属于 校 验 器 风格 。 
<field name="name"> 
<!-- 指定 name 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 


<message> 必 须 输入 名 字 </message> 


</field-validator> 


</field> 
A. 混乱 校 验 器 风格 B. 无 校 验 器 风格 
C. 非 字段 校 验 器 风格 D. 字段 校 验 器 风格 


< 全 


A 人 Web 开发 学 习 实 录 . 忆 


(4) Struts 2 中 与 验证 相关 的 注解 有 种 。 
A. 13 B. 14 
07 D: 18 
三 、 上 机 练习 
上 机 练习 : 完善 会 员 注 册 功 能 。 
要 求 : 


(1) 在 会 员 注册 系统 中 ， 对 会 员 姓 名 配置 表达 式 校 验 器 。 正 则 表达 式 验证 输入 的 姓名 只 能 
是 汉字 或 者 字母 ， 不 能 两 者 都 有 ， 也 不 能 包含 任何 符号 和 数字 。 当 用 户 输入 不 正确 时 提示 错误 
信息 ， 如 图 6-16 所 示 。 


图 6-16 输入 用 户 信息 


(2) 对 会 员 输 入 的 姓名 字段 加 上 短路 校 验 器 。 当 用 户 没有 在 姓名 文本 框 中 输入 任何 内 容 
时 ， 只 提示 一 条 信息 ， 如 图 6-17 所 示 。 


6-17 短路 校 验 输入 数据 
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内 容 摘要 : 
OGNL 是 一 种 用 于 访问 和 设置 对 象 数 据 的 强大 的 表达 式 语言 , 它 可 以 自动 导航 对 象 图 的 结 
构 ， 实 现 调用 对 象 方法 ， 操 作 集 合 ， 访 问 类 的 静态 成 员 ， 等 等 。 
本 章 详细 介绍 了 OGNL 表达 式 的 用 法 。 为 了 向 开发 人 员 提 供 更 好 的 开发 体验 ， 对 Struts 2 
在 OGNL 基础 上 的 增强 进行 了 一 一 讲解 。 最 后 针对 OGNL 使 用 中 的 常见 问题 进行 解答 。 
学 习 目标 : 
理解 OGNL 的 三 要 素 。 
掌握 OGNL 表达 式 的 使 用 。 
掌握 OGNL 对 集合 的 操作 。 
掌握 lambda 表达 式 的 使 用 。 
理解 值 栈 的 概念 。 
掌握 Struts 2 对 OGNL 表达 式 的 增强 。 
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7.1 ”使 用 OGNL 表 达 式 获取 数据 


OGNL 是 Object Graph Navigation Language( 对 象 图 导航 语言 ) 的 缩写 ， 是 一 种 表达 式 语 言 。 
使 用 这 种 表达 式 语 言 ， 读 者 可 以 通过 某 种 表达 式 语 法 ， 存 取 Java 对 象 树 中 的 任意 属性 、 调 用 
Java 对 象 树 的 方法 、 同 时 能 够 自动 实现 必要 的 类 型 转化 。 如 果 把 表达 式 看 做 是 一 个 带 有 语义 的 
字符 串 ， 那 么 OGNL 无 疑 成 为 了 这 个 语义 字符 串 与 Java 对 象 之 间 沟 通 的 桥梁 。 


9 
晤 视频 教学 ， 光盘 /videos/07/ognl 1.avi 长度 : 13 分 钟 
光盘 /videos/07/ognl 2.avi 人 @@ 长 度 : 12 分 名 


7.1.1 基础 知识 一 一 OGNL 基 础 


OGNL 表达 式 的 基础 单元 就 是 导航 链 (Navigation Chain)， 简 称 为 链 。 最 简单 的 链 由 三 个 音 
分 构成 : 属性 名 、 方 法 调用 和 数组 索引 。 本 节 将 对 OGNL 的 三 要 素 进行 基本 讲解 ， 希 望 读 者 
了 解 OGNL 的 内 部 结构 。 在 重点 讲解 OGNL 表达 式 使 用 的 同时 ， 读 者 需要 掌握 并 灵活 运用 表 
达 式 访问 操作 数据 。 

1. OGNL 三 要 素 


把 传 入 OGNL 的 API 的 三 个 参数 (Expression、Root Object 和 Context)， 称 之 为 OGNL 的 
三 要 素 。OGNL 的 操作 实际 上 就 是 围绕 着 这 三 个 参数 而 进行 的 。 

OGNL 的 API 来 自 于 OGNL 的 静态 方法 。 

public static Object getValue( Object exception, Map context, Object root ) 

throws OgnlException; 

public static void setValue ( Object tree, Map context, Object root, Object value ) 

throws OgnlException; 

1) ”表达 式 (Exception) 

表达 式 是 整个 OGNL 的 核心 ， 所 有 的 OGNL 操作 都 是 通过 解析 表达 式 后 进行 的 。 表 达 式 
指定 了 OGNL 操作 要 做 的 工作 。 

例如 : name、department.name 等 都 是 表达 式 ， 表 示 取 name 或 者 department 中 的 name 的 
值 。OGNL 支持 很 多 类 型 的 表达 式 ， 后 面 读 者 将 会 看 到 更 多 。 

2)” 根 对 象 (Root Object) 

根 对 象 可 以 理解 为 OGNL 要 操作 的 对 象 ， 在 表达 式 规 定 了 “要 做 的 工作 ”以 后 ， 需 要 指 
定 工作 的 操作 对 象 。 

比如 指定 user 就 是 根 对 象 ， 表 达 式 采用 name。 这 就 意味 着 ， 需 要 对 user 这 个 对 象 去 取 
name 这 个 属性 的 值 。 代 码 如 下 。 


Ogn1 .getValue (0Ogn1.parseExpression ("name")，User) 7 


>> 
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3) 上下文 环境 (Contexb 

有 了 表达 式 和 根 对 象 ， 实 际 上 已 经 可 以 使 用 OGNL 的 基本 功能 。 例 如 ， 根 据 表达 式 对 根 
对 象 进行 取 值 或 者 设 值 工作 。 

不 过 在 OGNL 的 内 部 ， 所 有 的 操作 都 会 在 一 个 特定 的 环境 中 运行 ， 这 个 环境 就 是 OGNL 
的 上 下 文 环境 (Contexb。 即 这 个 上 下 文 环境 (Contexb， 规 定 OGNL 的 操作 地 点 。 

OGNL 的 上 下 文 环 境 是 一 个 Map 结构 ， 称 为 OgnlContext。 上 面 提 到 的 根 对 象 (Root 
Object)， 事 实 上 也 会 被 加 入 到 上 下 文 环境 中 去 ， 并 且 这 将 作为 一 个 特殊 的 变量 进行 处 理 。 

OgnlContext 不 仅 提 供 了 OGNL 的 运行 环境 。 在 这 其 中 ， 还 能 设置 一 些 自 定义 的 parameter 
到 Context 中 ， 以 便 在 进行 OGNL 操作 的 时 候 能 够 方便 地 使 用 这 些 parameter。 

》 在 访问 parameter 时 ,需要 使 用 # 作 为 前 组 才能 进行 。 还 有 刚 提 到 的 Root Object 作 

注意 为 一 个 特殊 的 变量 进行 处 理 ， 具 体 就 表现 为 ， 针 对 根 对 象 的 存 取 操 作 的 表达 式 是 

不 需要 增加 # 符 号 进行 区 分 的 。 

2. OGNL 表 达 式 

OGNL 支持 各 种 复杂 的 表达 式 。 但 是 最 基本 的 表达 式 是 将 对 象 的 引用 值 用 “. ”串联 起 来 。 
从 左 到 右 , 每 一 次 表达 式 计算 返回 的 结果 成 为 当前 对 象 , 后 面部 分 接着 在 当前 对 象 上 进行 计算 ， 

-直到 全 部 表达 式 计算 完成 ,返回 最 后 得 到 的 对 象 OGNL 则 针对 这 条 基本 原则 进行 不 断 的 扩 
充 ， 从 而 使 之 支持 对 象 树 、 数 组 、 容 器 的 访问 等 操作 。 

下 面 是 一 些 常 用 的 OGNL 表达 式 。 

1) ”常量 

OGNL 支持 的 常量 除了 包含 Java 语言 的 常量 类 型 外 ， 还 提供 了 自 有 的 常量 类 型 ， 方 便 
OGNL 的 使 用 。 

OGNL 支持 的 所 有 常量 类 型 如 下 所 示 。 

(1) 字符 串 常量 。 使 用 单 引 号 或 双 引 号 括 起 来 的 字符 串 ， 例 如 : "Welcome to China'， 
"Welcome to China"。 在 Java 中 不 可 以 使 用 单 引 号 来 界定 字符 串 常量 ， 而 OGNL 中 可 以 。 不 过 
如 果 是 单个 字符 的 字符 串 常量 ， 则 必须 使 用 双 引 号 来 界定 ， 如 : "H"。OGNL 的 字符 串 也 支持 
转 义 序列 ， 例 如 : 要 在 JSP 页 面 中 输出 “You said，"Welcome to China"。”， 代 码 如 下 。 

<s:property value="'You said, \"Welcome to ChinaN"。'"/> 

(2) 字符 常量 。 用 单 引号 括 起 来 的 字符 。 例 如 : 'C'。 注 意 ， 不 能 使 用 双 引 号 ， 否 则 将 被 认 
为 是 字符 串 常量 。 

(3) 数值 常量 。 除 了 Java 中 的 int、long、float 和 double 外 ，OGNL 中 还 可 以 使 用 “b” 或 
“B” 后 级 指定 BigDecimal 常量 ， 用 “h” 或 “了 HH” 后 级 指定 BigInteger 常量 。 例 如 : 345(int 
常量 )、345l(long 常量 )、345.34f(float 常量 )、123.45(double 常量 )、23b(BigDecimal 常量 )、 
123h(BigInteger 常量 )。 

(4) 布尔 常量 。 布 尔 常量 只 有 两 个 值 : true 和 false。 


(5) null 常量 。 表 示 空 


座 
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2) ”基本 对 和 象 树 的 访问 

对 象 树 的 访问 就 是 通过 使 用 “. ”号 将 对 象 的 引用 串联 起 来 进行 。 如 下 所 示 。 

name、department .name、User.-department.factory-manager-name 

3) ”对 容器 变量 的 访问 

对 容器 变量 的 访问 ， 通 过 # 符 号 加 上 表达 式 进行 。 如 下 所 示 。 

#name、#department .name、#user.department.factory.manager.name 

4) “操作 符号 

OGNL 表达 式 中 能 使 用 的 操作 符 基 本 跟 Java 里 的 操作 符 一 样 ， 除 了 能 使 用 +、-、*、/ 人 、++、 
--、==、!=、= 等 操作 符 之 外 ， 还 能 使 用 mod、in、not in 等。 与 Java 相同 的 操作 符 (++、-、*、 

等) 就 不 做 详细 讲解 了 ， 下 面 对 OGNL 特有 的 操作 符 进行 讲解。 

(1) 逗号 (，) 或 序列 操作 符 。OGNL 的 去 号 操作 符 是 借鉴 C 语言 中 的 。 喜 号 被 用 于 分 隔 两 
个 或 多 个 独立 的 表达 式 ， 整 个 表达 式 的 值 是 最 后 一 个 子 表 达 式 的 值 。 例 如 : name， 
#manager.name。 

第 一 个 表达 式 name 和 第 二 个 表达 式 #manager.name 依次 被 计算 ， 整 个 表达 式 的 值 是 第 二 
个 表达 式 的 值 。 

(2) 花 括号 (f}) 操 作 符 。 花 括号 ({}) 操 作 符 用 于 创建 列表 。 使 用 花 括 号 将 元 素 括 起 来 ， 元素 
之 间 使 用 逗号 分 阳 ， 例 如 表达 式 {"Rose","Bob","Marry"}， 创 建 了 带 有 三 个 元 素 的 列表 。 

(3) in 和 not in 操作 符 。in 和 not in 操作 符 用 于 判断 一 个 值 是 否 在 集合 中 ， 例 如 : name 
infnull"sky"}|lname。 

5) 访问 JavaBean 的 属性 

访问 JavaBean 属性 的 表达 式 是 非常 常用 的 。 假如 有 一 个 employee 对 象 作 为 OGNL 上 下 文 
的 根 对 象 ， 那 么 就 对 应 于 下 列 的 表达 式 。 

(1) name。 相 当 于 Java 代码 : employee.getName()。 

(2) address.country。 相 当 于 Java 代码 : employee.getAddress.getCountry()。 

6) 容器 、 数 组、 对 象 

OGNL 支持 对 数组 和 ArrayList 等 容器 的 顺序 访问 。 如 下 所 示 。 


group.users[0]; 

同时 ，OGNL 支持 对 Map 的 按键 值 查找 。 如 下 所 示 。 
#session[mySessionPropKey] 

不 仅 如 此 ，OGNL 还 支持 容器 构造 的 表达 式 。 如 下 所 示 。 


{"green", "red", "blue"} // 构 造 一 个 List 
tevi" maluel" "key2" Value2777kKeV32VaIUWSS // 构 造 一 个 Map 


可 以 通过 任意 类 对 和 象 的 构造 函数 进行 对 象 新 建 。 如 下 所 示 。 


new java.net.URL("http://localhost") 
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7) ”对 静态 方法 或 变量 的 访问 
引用 类 的 静态 方法 和 字段 , 它们 的 表达 方式 是 一 样 的 @class@member 或 者 @class@method 
(args)。 如 下 所 示 。 


@com.java.core.Resource@ENABLE // 调 用 静态 字段 
@com.java.core.ResourceBgetAllResources () // 调 用 静态 方法 
8) 方法 调用 


可 以 直接 通过 类 似 Java 的 方法 调用 方式 进行 ， 也 可 以 通过 传递 参数 的 方式 。 如 下 所 示 。 


user.getName (); 
group.users.size(); 


group.containsUser (requestUser); 

9) ”调用 构造 方法 

OGNL 也 支持 对 构造 方法 的 调用 , 用 于 创建 一 个 新 的 对 象 。 可 以 像 在 Java 中 一 样 使 用 new 
操作 符 来 创建 一 个 对 象 ， 不 同 的 是 ， 必 须 使 用 完整 的 限定 类 名 ( 带 包 名 的 类 名 )， 如 下 所 示 。 


<s:property value="new com.struts2.action.model.Dog()"/> // 创 建 一 个 Dog 对象 


7.1.2 实例 描述 


星期 天 上 网 闲逛 时 ， 有 人 在 论坛 中 问 : 什么 是 OGNL， 还 要 顺便 给 个 例子 。 我 正好 没事 ， 
就 帮 他 写 了 个 例子 ， 主 要 就 是 使 用 OGNL 表达 式 获 取 一 些 简单 数据 。 这 个 例子 比较 适合 初学 
者 拿 来 练习 。 


7.1.3 实例 应 用 


【 例 7-1】 使 用 OGNL 表达 式 获取 数据 。 
(1) 首先 新 建 一 个 项 目 struts2_ 7， 然后 在 项 目的 sre 下 新 建 一 个 struts2.action 包 ， 最 后 在 
该 包 下 新 建 一 个 Person.java 类 ， 该 实体 类 中 声明 了 个 人 编号 no、 年 龄 age、 名 字 name 和 性 别 
sex。 代 码 如 下 所 示 。 


public class Person { 

private string no; // 个 人 编号 

private int age; // 年 龄 

private String name; // 名 字 

private String sex; // 性 别 

public Person(){} 

public Person(String no String sex) { 
super (); 
this.no = no; 


this.sex = sex? 
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} 

public String getNo() { 
return no; 

} 

public void setNo (String no) { 
this.no = no; 


} 


// 下 面 是 age、name 和 sex 属性 的 get、set 方法 ， 在 此 省 略 。 


i: 


(2) 定义 一 个 OgnlAction， 通 过 ActionContext 上 下 文 获取 request、session 和 application， 
并 分 别 为 它们 添加 参数 信息 ， 并 返回 ognl 结果 ， 


public class OgnlAction { 


private String name; // 声 明 name 属性 
Private List list = new ArrayList(); 


public List getList() { 
return list; 

} 

public void setList(List list) { 
this.list = list; 

} 


public String execute(){ 


name = " 张 三 " 


7 


list.add (p); 


HttpServletRequest requestl 


requestl1.setAttribute ("name", 


// 获取 session， 并 添加 信息 


Map session = RActionContext .getContext () .getSession() 7 
session.put ("name", "session Value") 7 


// 获 取 application， 并 添加 信息 


Map application = ActionContext.getContext() .getApplication(); 
application.put ("name", "application value"); 
return "ognl"; // 返 回 ogn1l 


public String getName() { 


return name; 


public void setName (String name) 


代码 如 下 所 示 。 


{ 


// 声 明 一 个 List 列表 


// 为 name 属性 设置 值 

Person p = new Person("1001"," 男 "); // 为 1ist 属性 添加 一 个 Person 对 象 
// 将 Person 对 象 p 添加 到 List 中 
Map request = (Map)ActionContext.getContext() .get ("request"); 

// 获 取 request， 并 在 request 中 添加 name 

ServletActionContext .getRequest (); 


"request value"); 
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(3) 在 项 目的 src 目录 下 新 建 一 个 struts.xml 文件 , 打开 该 文件 在 该 文件 中 添加 OgnlAction 
的 配置 ， 代 码 如 下 所 示 。 


<struts> 
<constant name="struts.action.extension" value="do"/> 
<!-- 注意 namespace 作用 --> 
<package name="myfirstl" extends="struts-default"> 
<action name="ognl" class="struts2.action.OgnlAction"> 
<result name="ognl">/ognl.jsp</result> <!-- 返回 ognl 跳 转 到 
ognl.jsp 页 面 --> 
</action> 
</package> 
</struts> 


(4) 创建 ognljsp 页 面 ,用 来 通过 ognl 表 达 式 获取 前 面 在 OgnlAction 中 放 在 request、session 
和 application 中 的 数据 。 代 码 如 下 所 示 。 


<body> 

<hl>$ {name}</h1l> 

<hr> 

获取 Action 属性 : <s:property value="name"/> 

<br> 

获取 Redeust 属性 : <s:property value="#request.name"/><br> 

获取 Session 属性 : <s:property value="#session.name"/><br> 

获取 Application 属性 : <s:property value="#application.name"/><br> 

<hr> 

获取 Action 中 List 属性 信息 

<s:property value="list[0] .no"/> 

<s:property value="list[0] .sex"/> 

<hr> 

方法 调用 <s:property value="name.length()"/><br> 

静态 属性 : <s : property value="@java.lang.Math@PI"></s:property> 
</body> 


7.1.4 运行 结果 
打开 正 浏 览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_7/ognl.do”，OgnlAction 请 


求 成 功 之 后 ， 将 跳 转 到 ognljsp 页 面 ， 在 该 页 面 中 显示 OGNL 表达 式 获取 的 数据 信息 ， 执 行 效 
果 如 图 7-1 所 示 。 
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图 7-1 OGNL 表 达 式 获取 的 数据 信息 


7.1.5 实例 分 析 


Ce 


本 实例 中 我 们 定义 了 一 个 OgnlAction， 通 过 ActionContext 上 下 文中 获取 request、session 
和 application 对 象 ， 并 为 它 添加 了 参数 name。 为 OgnlAction 的 name 属性 赋值 为 “ 张 三 ”， 并 
为 List 列表 添加 了 一 个 Person 对 象 。 当 请 求 OgnlAction 成 功 时 ， 跳 转 到 ognl.jsp 页 面 上 ， 在 该 
页 面 上 通过 OGNL 表达 式 分 别 获取 request、session 和 application 对 象 中 的 参数 值 ， 并 获取 
OgnlAction 的 name 属性 值 “ 张 三 ”，List 列表 中 的 Person 对 象 信息 


7.2 ”人员 集合 的 操作 
在 OGNL 表达 式 应 用 中 ， 对 集合 的 操作 使 用 是 非常 频繁 的 ， 本 节 将 详细 讲解 OGNL 对 集 


合 的 操作 。 
ca 视频 教学 : 光盘/videos/07/collection.avi 加 长 度 : 10 分钟 


7.2.1 基础 知识 一 一 OGNL 对 集合 的 操作 
OGNL 提供 了 对 Java 集合 API 非常 好 的 支持 ， 创 建 集合 并 对 其 进行 操作 是 OGNL 的 一 个 
基本 特性 。 本 节 将 看 一 下 创建 并 访问 集合 的 方式 ， 以 及 如 何 根据 集合 的 内 容 进行 投影 和 选择 。 
1. 创建 集合 


1) “创建 列表 
使 用 花 括 号 将 元 素 包 含 起 来 ， 元 素 之 间 使 用 有 逗号 分 隔 。 如 下 所 示 。 
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{'Marry', 'Jack', 'Rose'} 

接 下 来 定义 一 个 元 素 类 型 是 Sting， 包 含 两 个 元 素 的 List 对 象 ， 代 码 如 下 所 示 。 

List list = new ArrayList (2); 

list.add ("海燕 "); 

list.add ("豚鼠"); 

通过 索引 来 访问 列表 ， 如 : list[0]、{"Marry','Jack','Rose'}[1]。 

2) ”创建 数组 

OGNL 中 创建 数组 与 Java 语言 中 创建 数组 类 似 。 例 如 : 表达 式 : new String[]{"hello"," 


你 好 ","nihao"} 创 建 一 个 String 类 型 的 数组 ， 由 三 个 字符 串 值 “hello”、“ 你 好 ”、“nihao” 
组 成 。 


可 以 通过 索引 来 访问 ， 如 : array[0]。Java 中 数组 有 一 个 length 属性 可 以 获取 数组 的 长 度 。 


在 OGNL 中 也 可 以 直接 访问 ， 例 如 : array.length。 


3) ”创建 Map 

Map 使 用 特殊 的 语法 来 创建 ， 代 码 如 下 。 

#{"key": "value",..} 

如 果 想 指定 创建 的 Map 类 型 , 可 以 在 左 花 括号 前 制定 Map 实现 类 的 类 名 。 代码 如 下 所 示 。 
#@java.util.LinkedHashMap@{"key":"value", ...... } 

Map 通过 key 来 访问 ， 如 map["key"] 或 map.key。 

2. 集合 的 伪 属性 

Java 集合 API 提供 了 很 多 常用 的 方法 ， 如 : size0、isEmpty0 等 ， 但 这 些 方法 的 命名 并 不 


符合 JavaBean 对 于 属性 访问 器 方法 的 命名 要 求 ( 即 getXxx0 和 setXxx0)， 不 能 像 访问 JavaBean 
属性 一 样 来 调用 这 些 方法 。 为 了 方便 对 Java 集合 API 的 方法 调用 ，OGNL 提供 了 一 些 伪 属 性 ， 
使 得 可 以 按照 属性 的 访问 方式 来 调用 集合 中 的 方法 。 


OGNL 提供 的 集合 伪 属 性 如 表 7-1 所 示 。 
表 7-1 特殊 的 集合 伪 属 性 


集合 类 型 伪 属 性 OGNL 表达 式 Java 代码 
List、Set、Map size, isEmpty list.size, set.isEmpty list.size()， set.isEmptyO 
List iterator list, iterator list.iterator() 
Map keys, values map.keys, map.values Imap.keySet0，map.valuesO) 
Set iterator set.iterator set.iterator() 
Tterator next, hasNext iter.next, iter.hasNext iter.nextO，iter.hasNextO 

next, hasNext, 
enum.nextElement(), 

Enumeration nextElement, enum.next, enum.hasNext 


enum.hasMoreElements() 


hasMoreElements 


<——— 
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@ ”Enumeration 的 两 对 伪 属 性 是 同 义 的 ， 即 next 等 价 于 nextElement，hasNext 等 价 于 
注意 hasMoreElements. 


3. 投影 与 选择 


OGNL 支持 类 似 数据 库 中 的 投影 (projection) 和 选择 (selection)。 
1) 投影 
投影 就 是 选 出 集合 中 每 个 元 素 的 相同 属性 组 成 新 的 集合 ， 类 似 于 关系 数据 库 的 字段 操作 。 


投影 操作 语法 所 下 。 


collection. {XxXX} 

其 中 XXX 是 这 个 集合 中 每 个 元 素 的 公共 属性 。 代 码 如 下 。 

group.userList. {username} // 将 获得 某 个 group 中 的 所 有 user 的 name 的 列表 

2) ”选择 

选择 就 是 过 滤 满 足 selection 条 件 的 集合 元 素 ， 类似 于 关系 数据 库 的 纪录 操作 。 选 择 操作 的 


语法 为 如 下 。 


Collection.{X YYY} 

其 中 义 是 一 个 选择 操作 符 ， 后 面 则 是 选择 用 的 逻辑 表达 式 。 选 择 操 作 符 有 三 种 。 
@ ?; 选择 满足 条 件 的 所 有 元 素 。 

@ “: 选择 满足 条 件 的 第 一 个 元 素 。 

@ 3$: 选择 满足 条 件 的 最 后 一 个 元 素 。 
例子 如 下 所 示 。 
#employees.{?#this.salary>3000} 

将 返回 薪水 大 于 3000 的 所 有 员工 的 列表 。 
#employees.{^#this.salary>3000} 

将 返回 第 一 个 薪水 大 于 3000 的 员工 的 列表 。 
#employees. {$#this.salary>3000} 


将 返回 最 后 一 个 薪水 大 于 3000 的 员工 的 列表 。 


7.2.2 ”实例 描述 


作为 程序 开发 者 ， 整 天 都 有 忙 不 完 的 项 目 。 还 好 现在 手头 的 项 目 马 上 就 完工 了 。 看 着 自己 


的 累累 硕果 ， 心 里 还 是 很 开心 的 ， 辛 苦 一 点 也 值得 。 在 这 个 项 目 中 ， 使 用 Struts 2 的 OGNL 比 
较 多 , 主要 就 是 对 OGNL 集合 的 操作 ， 做 这 个 项 目 使 我 对 OGNL 集合 的 操作 有 了 深入 的 理解 。 
今天 抽空 写 了 个 例子 ， 把 我 的 收获 与 读者 分 享 一 下 。 


>> 
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7.2.3 ”实例 应 用 


【 例 7-2】 人 员 集 合 的 操作 。 
(1) 本 实例 引用 了 7.1.4 节 实 例 中 的 Person 类 ， 并 在 该 类 中 添加 了 一 个 带 参 构造 方法 ， 代 
码 如 下 所 示 。 


public Person (String no,int agerString namerString sex){ 


this.no = no; // 编 号 
this.age = age; / /年龄 
this.name = name;  // 姓 名 
this.sex = sex; // 性 别 


(2) 在 项 目 src/struts2/action 目录 下 , 新 建 一 个 OgnlPersonAction, 该 Action 中 定义 了 一 个 
List 用 于 存储 Person 对 象 的 集合 ， 在 request、session 和 application 中 放 入 了 username 参数 。 
代码 如 下 所 示 。 


public class OgnlPersonAction extends ActionSupport{ 


private List<Person> persons; 

public void setPersons(List<Person> persons) { 
this.persons = persons; 

} 

public List<Person> getPersons() { 
return persons; 

} 

public String execute() { 
HttpServletRequest request = ServletActionContext.getRequest (); 
request.setAttribute ("userName", "Max From request"); 
// 获 取 session， 并 添加 信息 
Map session = ActionContext.getContext() .getSession(); 
session.put ("userName", "Max From session"); 
// 获 取 application， 并 添加 信息 
Map application = ActionContext.getContext() .getApplication(); 
application.put ("userName", "Max From application"); 
persons = new LinkedList<Person>(); 
// 向 persons 集合 中 添加 Person 对 象 
persons -add (new Person("2010-619678"，25，," 马 海 涛 "，," 男 ") ) ; 
Persons .add (new Person("2010-007867"，42," 赵 海燕 "," 女 ")); 
persons.add (new Person("2010-633610"，68," 蔡 文静 "," 女 ")); 
persons.add (new Person ("2010-527341"，22, “" 郭 小 刚 ", " 男 ")); 
persons.add (new Person ("2010-605350"，37, "赵文卓 ", " 男 ")); 


return "ognl"™; 


< 
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(3) 打开 src 目录 下 的 struts.xml 文件 ， 添 加 OgnlPersonAction 的 配置 ， 代 码 如 下 所 示 。 


<package name="Struts2 OGNL DEMO” extends="struts-default"> 
<action name="ognlperson" class="struts2.action.OgnlPersonAction"> 
<result name="ognl">/ognlperson.jsp</result> 
</action> 


</package> 


(4) 新 建 一 个 onglperson.jsp 页 面 ， 在 该 页 面 中 首先 访问 OGNL 上 下 文 和 Action 上 下 文 取 
出 request、session、application 和 attr 中 的 参数 usermame， 然 后 通过 过 滤 和 投影 (projecting) 集 
合 ， 在 页 面 中 显示 出 年 龄 大 于 30 的 人 员 ， 最 后 构造 Map 集合 ， 使 用 OGNL 取出 Map 集合 中 
数据 ， 代 码 如 下 所 示 。 


<body> 

<h3> 访 问 OGNL 上 下 文 和 Action 上 下 文 </h3> 

<p>request .userName: <s:property value="#request.userName" /></p> 

<p>session.userName: <s:property value="#session.userName" /></p> 

<p>application.userName: <s:property value="#application.userName" /></p> 

<p>attr.userName: <s:property value="#attr.userName" /></p> 

hr 

<h3> 用 于 过 滤 和 投影 (projecting) 集 合 </h3> 

<p> 年 龄 大 于 30 岁 的 人 </p> 

<ul> 

<s:iterator value="persons.{?#this.age > 30}"> 
<li><s:property value="name" /> 年 龄 : <s:property Value="age" 
WA 
</s:iterator> 

</ul> 

<p> 赵 海燕 的 年 龄 : <s:property value="persons.{?#this.name==" 赵 海燕 
'}.{age} [0]"/></p> 

<h3> 构 造 Map</h3> 

<s:set name="foobar" value="#{' 语 文 ':'86', ' 数 学 ':'100'}"/> 

<p> 语 文成 绩 : <s:property value="#foobar[' 语 文 ']" /></p> 
</body> 


完成 实例 代码 后 ， 打 开 下 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_7/ 
ognlperson.action”， 执 行 效果 如 图 7-2 所 示 。 
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7-2 ”人员 集合 的 操作 


7.2.5 ”实例 分 析 


Ce 


上 述 实 例 主 要 通过 一 个 OgnlPersonAction, 在 Action 中 声明 了 一 个 List 集合 列表 用 来 存储 
了 Person 对 象 ， 通 过 使 用 表达 式 “persons.{?#this.age > 30}” 依 次 迭代 获取 集合 中 年 龄 大 于 30 岁 
的 人 ， 将 这 些 人 的 信息 显示 在 页 面 中 。 


7.3 公司 员工 性 别 调查 


“lambda 表达 式 ” 是 一 个 匿名 函数 ， 它 可 以 包含 表达 式 和 语句 ， 并 且 可 用 于 创建 委托 
或 表达 式 目 录 树 类 型 。OGNL 中 也 提供 了 一 种 lambda 表达 式 语法 。 本 节 将 讲解 它 的 具体 使 
用 情况 。 
上 视频 教学 ， 光 盘 /videos/0Tllambda avi 侈 长 度 : 10 分 名 


7.3.1 基础 知识 一 一 lambda 表 达 式 


OGNL 有 一 个 简化 的 lambda 表达 式 语 法 ， 能 够 让 读者 写 一 些 简单 的 功能 。 定 义 lambda 表 
达 式 的 语法 如 下 。 
| 
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OGNL 中 的 lambda 表达 式 只 能 使 用 一 个 参数 ， 但 这 个 参数 可 以 通过 #this 变量 来 引用 。 
OGNL 将 lambda 表达 式 看 作 是 常量 。 举 个 例子 ， 声 明 一 个 使 用 递归 来 计算 阶乘 的 函数 ， 然 后 
调用 它 ， 代 码 如 下 。 

#fact = :[#this<=1?1:#this*#fact (#this-1)],#fact(30H) 

lambda 表达 式 是 方 括号 ([]) 中 的 部 分 。#this 变量 代表 表达 式 的 参数 ， 它 的 初始 值 是 30H( 后 
级 HH 表示 这 是 一 个 BigInteger 常量 )， 每 一 次 递归 调用 表达 式 都 将 参数 的 值 减 1。 整 个 OGNL 
表达 式 是 一 个 使 用 了 逗号 (，) 操 作 符 的 表达 式 ， 它 的 值 就 是 调用 lambda 表达 式 的 值 。 

声明 一 个 计算 斐 波 那 契 数列 的 函数 ， 代 码 如 下 。 

#fib=: [#this==02?0:#this==121:#fib(#this-2)+#fib(#this-1)] //#this 变量 代表 表 

达 式 的 参数 

上 面 仅 定义 了 一 个 lambda 表达 式 。 如 何 调用 这 个 表达 式 呢 ? 代码 如 下 所 示 。 

#fib(11) // 调 用 了 上 述 表达 式 ，#this 变量 的 初始 值 为 11 


7.3.2 实例 描述 


在 实际 开发 中 我 经 常 使 用 OGNL， 不 过 OGNL 中 的 lambda 表达 式 ， 我 用 得 较 少 。 前 天 我 
没事 在 那儿 研究 了 一 下 ， 突 然 发 现 lambda 表达 式 原 来 这 么 强大 。 原 来 要 费 很 大 工夫 才能 实现 
的 功能 ， 现 在 只 要 短 短 一 个 小 式 子 就 可 以 实现 了 。 本 实例 将 使 用 lambda 表达 式 实 现 一 个 将 int 
类 型 的 性 别 字段 值 ， 通 过 简单 判断 ， 在 页 面 上 显示 成 “ 男 ” 和 “ 女 ” 字 符 串 。 


7.3.3 实例 应 用 


【 例 7-3】 公司 员工 性 别 调查 。 

(1) 首先 抽象 封装 一 个 员工 类 Employee， 声明 员工 编号 (no)、 员 工 名 称 (name)、 年 龄 (age)、 
性 别 (sex) 和 职位 Gob) 等 属性 ， 将 属性 sex 定义 为 int 类 型 (属性 值 为 1: 女 、2: 男 )， 分 别 给 出 各 
属性 的 get 和 set 方法 ， 声 明 一 个 Employee 的 带 参 构造 函数 ， 实 现代 码 如 下 所 示 。 

public class Employee { 


private String no; // 编 号 
private String name; // 名 称 


private int age // 年 龄 

Private int sex; // 性 别 

private String job; // 职 位 

public Employee(String no ,String name,int age,int sex,String job){ 
// 构 造 函 数 


this.no = no; 
this.name = name; 
this.age = 
this.sex = sex; 
this.job = 
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public String getNo() { 
return no; 
} 
public void setNo (String no) { 
this.no = no; 
} 
// 下 面 是 员工 名 称 、 年 龄 、 性 别 和 职位 属性 的 get 和 set 方法 ， 在 此 省 略 。 
是 


(2) 创建 一 个 EmployeeAction， 声 明 一 个 List 用 来 存储 Employee 对 象 ， 
法 ， 在 该 方法 中 初始 化 员工 列表 ， 代 码 如 下 所 示 。 


public class EmployeeAction extends ActionSupport{ 
private List<Employee> employees; // 公 司 员工 信息 列表 
public List<Employee> getEmployees() { // 获 取 公 司 员工 信息 列表 
return employees; 


1 execute() 方 


} 
public void setEmployees (List<Employee> employees) { /1 设置 员工 信息 列表 
this.employees = employees; 


} 

public String execute() { 
employees = new LinkedList<Employee>(); /1 初始化 员工 信息 列表 
// 向 列表 中 添加 员工 对 象 。 


employees .add (new Employee ("20051025"," 李 梅 ", 28,1," 财 政 主管 ") ) ; 
employees.add (new Employee ("20010509"," 张 瑞 ", 34,2, "市 场 部 经 理 ") ) 
employees .add (new Employee ("20091015"," 黄 炳 ", 38,2, "行政 部 经 理 ") ) ; 
employees.add (new Employee ("20100229"," 周 静 ", 23, 1, "设计 部 职员 ") ); 
employees .add (new Employee ("20030416"," 郭 晓 斌 ", 25, 2, "技术 部 组 长 ") ) ; 
return "ognl"; 


} 
(3) 在 项 目 src 目录 下 struts.xml 文件 中 添加 EmployeeAction 的 配置 ， 代 码 如 下 所 示 。 


<package name="Struts2 Lambda DEMO" extends="struts-default"> 
<action name="employee" class="struts2.action.EmployeeAction"> 
<result name="ognl">/employee.jsp</result> 
</action> 
</package> 


(4) 新 建 一 个 employee.jsp， 该 页 面 用 来 显示 公司 员工 的 性 别 普 查 结果 ， 前 面 封 装 的 
Employee 类 中 将 性 别 属性 sex 声明 为 int 类 型 (1: 女 、2: 男 )， 这 里 可 以 使 用 本 节 讲 的 lambda 
表达 式 将 int 类 型 的 性 别 值 转换 成 字符 串 “ 男 ”和 “ 女 ”， 显 示 在 页 面 上 ， 使 用 户 看 起 来 更 加 
清晰 明朗 ， 代 码 如 下 所 示 。 

<s:iterator value="employees"> 

<1i> 
<s:property value="name"” /> 性 别 : 


< 二 一 
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<!--lambda 表达 式 将 当前 员工 的 性 别 值 传 入 conv 函数 ， 判 断 值 为 1 显示 “ 女 ”, 值 为 2 显示 “ 男 ”， 
其 他 显示 空白 --> 
<s:property value="#conyv =: [#this==1?' 女 ':#this==2?' 男 ':'']， 
#conv (#this.sex)" /> 
s/s 


</s:iterator> 


7.3.4 运行 结果 


启动 服务 器 之 后 ， 打 开 正 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_7/ 
employee.action”， 执 行 成 功 后 显示 员工 性 别 调查 结果 ， 如 图 7-3 所 示 。 


7-3 ”员工 性 别 调查 


7.3.5 实例 分 析 


ee 


本 实例 封装 了 一 个 Employee 类 ， 声 明了 编号 no)、 名 称 (name) 和 性 别 (sex) 等 属性 。 其 中 属 
性 sex 为 int 类 型 (1: 女 、2: 男 )， 当 把 员工 性 别 信息 显示 在 页 面 上 时 , 通过 lambda 表达 式 #conv 
=:[#this 一 17' 女 ':#this 一 27' 男 :"], #conv(#this.sex) 创 建 了 一 个 conv 函数 ， 当 判断 员工 性 别 属 性 值 
为 1， 在 页 面 中 显示 “ 女 ”， 为 2 显示 “ 男 ”。 


7.4 获取 建材 信息 
Stmts 2 对 OGNL 表达 式 的 增强 ， 值 栈 、[N] 语 法 、top 关键 字 、 访 问 租 态 成 员 、 值 栈 中 的 
Action 实例 和 Struts 2 中 的 命名 对 象 。 本 节 将 对 这 些 增强 一 一 进行 讲解 。 


A9 
时? 视频 教学 : 光盘 /videos/07/struts2_ognl.avi @ 长 度 : 11 分钟 


mm >> 
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7.4.1 基础 知识 一 一 Struts 2 对 OGNL 表 达 式 的 增强 
Stmts 2 在 OGNL 之 上 提供 的 最 大 附加 特性 就 是 支持 值 栈 (ValueStack)。 在 OGNL 上 下 文中 
只 能 有 一 个 根 对 象 ，Struts 2 的 值 栈 则 允许 存在 许多 虚拟 根 对 象 。 


1. 值 栈 (ValueStack) 


Stmts 2 将 OGNL 上 下 文 设 置 为 Struts 2 中 的 ActionContext( 内 部 使 用 的 仍然 是 
OgnlContext)， 并 将 值 栈 作 为 OGNL 的 根 对 象 。 值 栈 与 正常 的 栈 很 类 似 ， 也 遵循 后 进 先 出 的 规 
则 ， 可 以 在 值 栈 中 放 入 、 删 除 和 查询 对 象 ， 值 栈 是 Struts 2 的 核心 。 

值 栈 通过 一 个 接口 (com.opensymphony.xwork2.util.ValueStack) 来 定义 ， 对 应 的 实现 类 是 
com.opensymphony.xwork2.util.OgnlValueStack。 

顺 着 值 栈 ， 框 架 在 ActionContext 中 还 放置 了 其 他 对 象 ， 包 括 表示 application、session 和 
request 的 Map 对 象 。 这 些 对 象 共 存 于 ActionContext 中 ， 靠 在 值 栈 (OGNL 根 对 象 ) 的 旁边 ， 如 
图 7-4 所 示 。 


图 7-4 值 栈 


直接 访问 OGNL 上 下 文中 的 根 对 象 时 ， 不 需要 使 用 “#” 来 标记 。 而 引用 上 下 文中 的 其 他 
对 象 时 则 需要 使 用 “#” 来 标记 。 由 于 值 栈 是 上 下 文中 的 根 对 象 ， 因 此 可 以 直接 访问 。 那 么 值 
栈 中 的 对 象 又 该 如 何 访 问 呢 ?Struts 2 提供 了 一 个 秘密 武器 一 OGNLPropertyAccessor(ognl. 
ObjectPropertyAccessor 是 一 个 接口 ，Stmts 2 提供 的 实现 类 是 一 个 静态 的 内 部 类 
OgnlValueStack.ObjectAccessor)。 它 可 以 自动 查询 栈 内 的 所 有 对 象 ( 从 栈 项 到 栈 底 )， 直到 找到 一 
个 所 查找 的 属性 的 对 象 ,也 就 是 说 , 对 于 值 栈 中 的 任何 对 象 都 可 以 直接 访问 , 而 不 需要 使 用 “#”。 

举 个 例子 ， 假 设 值 栈 中 有 两 个 对 象 : Student 和 Class， 两 个 对 象 都 有 name 属性 ，Student 
有 学 号 属性 number， Class 有 学 员 总 数 属性 stu_num。Class 先入 栈 ，Student 后 入 栈 ， 位 于 栈 
顶 ， 如 图 7-5 所 示 。 


< 寺 ——— 


栈 顶 


图 7-5 一 个 包含 Student 和 Class 对 象 的 简单 值 栈 


对 于 表达 式 name, 访问 的 就 是 Student 对 象 的 name 属性 ， 因 为 Student 对 象 位 于 栈 顶 ; 表 
达 式 stu_ num， 访 问 的 就 是 Class 对 象 的 stu_num 属性 。 访 问 值 栈 中 的 对 象 属性 或 方法 ， 无 须 
指明 对 象 ， 也 不 用 “#”， 就 好 像 值 栈 中 的 对 象 都 是 OGNL 上 下 文 的 根 对 象 一 样 。 这 就 是 Struts 
2 在 OGNL 基础 上 做 出 的 改进 。 

2，[N] 语 法 

如 果 想 要 访问 Class 的 name 属性 ， 应 该 如 何 写 表达 式 呢 ? 可 以 使 用 [IN].xxxGN 是 从 0 开始 
的 整数 ) 这 样 的 语法 来 指定 从 哪 一 个 位 置 开始 向 下 查找 对 象 的 属性 , 表达 式 [1].name 访问 的 就 是 
Class 对 象 的 name 属性 。 

在 使 用 [IN].xxx 语法 时 ， 要 注意 位 置 序号 的 含义 ， 它 并 不 是 表示 “获取 栈 中 索引 为 N 的 对 
象 ”, 而 是 截取 从 位 置 N 开始 的 部 分 栈 。 假 设 现在 栈 中 有 三 个 对 象 : Object0、Objectl 和 Object2， 
Object0 和 Object2 都 有 name 属性 ， 如 图 7-6 所 示 。 
表达 式 name 访问 的 是 Object0 的 name 属性 ，[1] 是 一 个 包含 了 Objectl 和 Object2 的 部 分 
栈 ， 由 于 只 有 Object2 有 name 属性 ， 所 以 [1].name 访问 的 是 Object2 的 name 属性 。 如 图 7-7 
表达 式 : name 


表达 式 : [1].name 一 一 一 


图 7-6 值 栈 中 包含 三 个 对 象 图 7-7 访问 [1].name 
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3. top 关 键 字 

通过 上 面 的 学 习 ， 读 者 对 访问 栈 中 对 象 的 属性 和 方法 应 该 没有 问题 了 。 但 能 和 否 直接 访问 栈 
中 的 对 象 昵 ? Struts 2 引入 了 一 个 新 的 关键 字 : top， 用 于 获取 栈 顶 的 对 象 。 对 于 如 图 7-6 所 示 
的 栈 ， 表 达 式 top 获取 的 就 是 Object0 这 个 对 象 本 身 。 结 合 [IN].xxx 语法 ， 可 以 获取 栈 中 任意 位 
置 的 对 象 。 例 如 [0].top 获取 Object0( 等 同 于 top)，[1].top 获取 Objectl ，[2].top 获取 Object2， 
[2].top.name 访问 Object2 中 的 name 属性 。 

4. 访问 静态 成 员 

除了 使 用 标准 的 OGNL 表达 式 访问 静态 字段 和 静态 方法 外 ，Struts 2 还 允许 不 指定 完整 的 
类 名 ， 而 是 通过 vs 前 级 来 调用 保存 在 栈 中 的 静态 字段 和 静态 方法 。 例 如 下 面 所 示 。 

@vs@FOO PROPERTY 

@vs@someMethod () 

@vsl@someMethod() 

vs 表示 ValueStack， 如 果 只 有 vs， 那么 将 使 用 栈 项 对 象 的 类 ;如 果 在 vs 后 面 跟 上 一 个 数 
字 ， 那 么 将 使 用 栈 中 指定 位 置 处 的 对 象 类 。 

Struts 2 中 提供 了 一 些 访 问 静 态 成 员 的 方式 , 但 是 默认 是 关闭 的 。 需 要 使 用 时 , 可 以 在 Struts 
2 的 配置 文件 中 添加 入 如 下 设置 代码 。 

<constant name="struts.ognl.allowStaticMethodAccess" value="true"/> 

设置 之 后 就 可 以 用 以 下 的 表达 式 来 访问 静态 成 员 了 。 代 码 如 下 所 示 。 

<s:property value="@com.struts2.util.DBUtil@getName ()"/> // 访 问 静态 方法 

<s:property value="@ com.struts2.util.DBUtil@Index Title"/>  // 访 问 静 态 常量 


5. 值 栈 中 的 Action 实 例 

Struts 2 框架 总 是 把 Action 实例 放置 在 栈 项 。 因 为 Action 在 值 栈 中 ， 而 值 栈 又 是 OGNL 的 
根 ， 所 以 引用 Action 的 属性 可 以 省 略 “# ”标记 ， 这 也 是 在 结果 页 面 中 直接 访问 Action 的 属性 
的 原因 ， 代 码 如 下 。 


<s:property value="name"/> 


<s:property> 标 签 输 出 栈 项 的 Action 实例 的 name 属性 值 。 但 是 ， 如 果 访 问 ActionContext 
中 的 其 他 对 象 ， 则 必须 使 用 “#” 号 ， 以 便 让 OGNL 知道 不 是 在 根 对 象 ( 即 值 栈 ) 中 查看 ， 而 是 
查看 ActionContext 中 的 其 他 对 象 。 

6. Struts 2 中 的 命名 对 象 


Struts 2 还 提供 了 一 些 命名 对 象 ， 这 些 对 象 没有 保存 在 值 栈 中 ， 而 是 保存 在 ActionContext 
中 , 因此 访问 这 些 对 象 需要 使 用 “# ”标记 。 这 些 命名 对 象 都 是 Map 类 型 。 如 : parameters request、 
session， 等 等 。 下 面 对 它 们 进行 详细 讲解 。 


< 
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1) parameters 
parameters 用 于 访问 请 求 参数 。 如 : 元 arameters['id] 或 却 arametersid， 相 当 于 调用 了 
HttpServletRequest 对 象 的 getParameter() 方 法 。 


外 $》 ”parameters 本 质 上 是 一 个 使 用 HttpServletRequest 对 象 中 的 请 求 参数 构造 的 Map 对 
注意 象 ， 一 旦 对 象 被 创建 (在 调用 Action 实例 之 前 就 已 经 创建 好 了 )， 它 和 
HttpServletRequest 对 象 就 没有 了 任何 关系 。 


2) request 

Tequest 用 于 访问 请 求 属性 。 如 : #request['user'] 或 #request.user ， 相当 于 调用 了 
HttpServletRequest 对 象 的 getAttribute() 方 法 。 

3) session 

session 用 于 访问 session 属性 。 如: #session["user'] 或 #session.user, 相当 于 调用 了 HttpSession 
对 象 的 getAttribute() 方 法 。 

4) application 

application 用 于 访问 application 属性 。 如 : #application[user] 或 #application.user， 相 当 于 调 
用 了 ServletContext 的 getAttribute() 方 法 。 


5) attr 
如 果 PageContext 可 用 ， 则 访问 PageContext， 和 否则 依次 搜索 request、session 和 application 
对 象 。 


7.4.2 ”实例 描述 


前 段 时 间 ， 一 个 朋友 问 我 Struts 2 对 OGNL 都 有 哪些 增强 ， 如 何 使 用 它们 。 当 时 被 问 的 丈 
二 和 尚 摸 不 着 头脑 ， 因 为 关于 这 个 我 还 真 没 总 结 过 ， 以 前 只 知道 项 目 中 用 到 过 ， 有 具体 说 还 真 不 
知道 该 怎么 说 。 于是， 我 花 了 点 功夫 总 结 了 一 下 ， 也 做 了 个 例子 ， 拿 出 来 和 读者 分 享 一 下 。 实 
例 中 主要 用 到 的 是 对 值 栈 中 的 Action 实例 和 Struts 2 中 的 命名 对 象 的 访问 与 操作 。 


7.4.3 ”实例 应 用 


【 例 7-4】 获取 建材 信息 。 
(1) 首先 封装 一 个 建筑 材料 实体 类 Material, 声明 材料 名 (materialName)、 材 料 价格 (mainbid) 
和 材料 数量 (mount) 属 性 ， 并 分 别 定义 所 有 属性 的 get 和 set 方法 ， 代 码 如 下 所 示 。 


public class Material { 
private String materialName; // 材 料 名 
private int mainbid; // 材 料 价格 
private int mount; // 材 料 数量 
// 构 造 初始 化 数据 


public Material(String materialName，int mainbid，int mount) {// 构 造 函数 
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this.materialName = materialName; 
this.mainbid = mainbid; 


this.mount = mount; 


public String getMaterialName (){ 
return materialName; 


public void setMaterialName (String materialName) { 
this.materialName = materialName; 


} 
// 下 面 是 属性 材料 价格 mainbid 和 材料 数量 mount 的 get、set 方法 ， 在 此 省 略 了 。 


有 

(2) 然后 定义 一 个 AddOgnlAction, 声明 Struts 2 中 的 两 个 命名 对 象 request 和 session 对 象 ， 
还 声明 一 个 存储 材料 对 象 的 集合 materials， 接 下 来 重 写 继承 自 ActionSupport 类 的 execute() 方 
法 ， 在 该 方法 中 向 request、session 对 象 中 放 入 materialName 参数 ， 然 后 向 材料 集合 中 添加 材 
料 对 象 ， 代 码 如 下 所 示 。 

public class RddognlRAction extends ActionSupport { 


// 设 置 request、response 参数 和 需要 显示 的 数据 集合 定义 


private HttpServletRequest request; 


private HttpSession session; 
private List<Material> materials; 
public String execute() throws Exception { 
request = ServletActionContext .getRequest (); 
session=request .getSession(); 
// 设 置 request、session 存放 值 
request.setAttribute ("materialName", "人造 石 台面 From request"); 
session.setAttribute ("materialName", " 欧 龙 无 茶 油 漆 (六 度 ) From session"); 


// 初 始 化 数据 集合 ， 集 合 类 型 为 List 
materials = new ArrayList<Material>(); 
materials .add (new Material(" 欧 龙 无 茶 油 漆 ( 六 度 )"，100，2000))，; 
materials .add (new Material ("6*10mm 门 套 线 红 影 木 夹板 饰 面 ( 单 面 ) "， 20， 
2900) ) 7 
materials .add(new Material(" 人 造 石 台面 "，56，800) ) 
return SUCCESS; 
} 
public HttpServletRequest getRequest() { 
return request; 


本 
public void setRequest (HttpServletRequest request) { 


this.request = request; 


< 于 
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} 

public HttpSession getSession() { 
return session; 

} 

public void setSession(HttpSession session) { 
this.session = session; 

} 

public List<Material> getMaterials() { 
return materials; 

} 

public void setMaterials (List<Material> materials) { 
this.materials = materials; 


; 


(3) 接 下 来 打开 项 目 src 目录 下 的 struts.xml 文件 ,向 该 文件 中 添加 AddOgnlAction 的 配置 ， 
代码 如 下 所 示 。 


<package name="AddOgnl" extends="struts-default"> 
<!-- 创建 Action --> 
<action name="add ognl" class="struts2.action.AddognlAction"> 


<result name="success">/add ognl.jsp</result> 


</action> 
</package> 
(4) 最 后 新 建 一 个 add_ognljsp 文件 ， 在 该 文件 中 使 用 Struts 2 中 的 命名 对 象 request 和 


session 直接 获取 它们 中 的 参数 ， 直 接 访问 栈 顶 Action 实例 的 材料 列表 属性 materials， 输 出 显 
示 材 料 信息 ， 代 码 如 下 所 示 。 


<body> 
<!-- OGNL 显示 request、response 中 的 值 --> 
<h3 align="left">Session 和 Request 值 </h3> 
Fequest .materialName: <s:property value="#request.materialName" /><br/> 


session.materialName: <s:property value="#session.get('materialName')" 
/><br/> 


<!-- ”OGNL 显示 条 件 表达 式 过 滤 的 数据 --> 
<h3 align="left"> 根 据 条 件 显示 数据 </h3> 
<p> 价 格 小 于 50 元 的 建材 </p> 
<ul> 
<s:iterator value="materials.{?#this.mainbid <50}"> 
<li><s:property value="materialName"/> 建材 价格 是 <s:property 
value="mainbid"/> 
元 !</1i> 
</s:iterator> 
</ul> 
<p> "人 造 石 台面 ”的 库存 数量 是 : <s:property 


value="materials.{?#this.materialName-=="' 人 造 
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的 
石 台面 '}. {mount}[0]"/></p> 
<!-- OGNL 新 建 Map 类 型 数据 集合 ， 显 示 子 元 素 值 -> 
<h3 align="left">Map 数据 显示 </h3> 
<s:set name="frank"” value="#{'material' :' 欧 龙 无 莱 油 漆 ( 六 度 ) '， 
mount us00rp /> 
<p> 供 销 商 frank 手 里 还 有 建材 <s:property value="#frank['material']" /></p> 
<p> 库 存量 为 <s :property value="#frank['mount']" /></p> 
</body> 


7.4.4 运行 结果 


打开 下 浏览 器 ， 在 地 址 栏 中 输入 “http:Wlocalhost:8080/Struts2_7/add_ognlaction”， 执 行 
效果 如 图 7-8 所 示 。 


ma 
[TI 


7-8 获取 建材 信息 


7.4.5 实例 分 析 


ee 


上 述 案例 中 ， 我 们 封装 了 一 个 建筑 材料 实体 类 Material， 并 创建 了 一 个 AddOgnlAction， 
在 该 Action 中 声明 了 Struts 2 中 的 命名 对 象 request 和 session 对 象 和 一 个 材料 对 象 集合 
materials。 当 用 户 请 求 AddOgnlAction 成 功 时 ， 跳 转 到 add_ognl.jsp 页 面 中 。 由 于 request 对 象 
和 session 对 象 不 在 值 栈 中 ， 所 以 在 ActionContext 中 ， 使 用 加 上 “ 拓 前 缓 的 表达 式 来 访问 它 
们 中 的 参数 ， 如 项 目 中 的 : “后 equest.materialName”。 由 于 Action 实例 默认 放 在 值 栈 的 栈 顶 ， 
所 以 可 以 不 加 “# ”前 组 ， 直 接 访 问 AddOgnlAction 中 的 材料 对 象 集合 materials， 如 项 目 中 的 : 

“materials. {?#this.mainbid <50}” 。 
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7.5.1 OGNL 运 算 问 题 


OGNL 运算 问题 ? 
网 络 课堂 : http://bbs.itzcn.com/thread-10996-1-1.html 


request 作用 域 里 面 有 一 变量 cur=4， 在 页 面 中 用 struts2 的 站 标签 将 它 取 出 ， 代 码 如 下 。 


<s: if test="#request.cur==4"></s:if> 


这 样 只 能 实现 简单 的 逻辑 ， 现 在 想 把 cur 除 以 5， 看 余数 是 否 为 1。 求 高 手 解答 。 
【解决 办 法 】: 这 个 不 难 实现 ， 其 代码 如 下 所 示 。 
<s:set name="cur" scope="request" value="4"></s:set> 
<s:if test="(#request.cur%®%5)==1"> 
取 余 为 1 
</s:if> 
<s:else> 
取 余 不 为 1 


</s:else> 


7.5.2 OGNL 调 用 方法 : #session.cart.showcart() 访 问 不 到 


ognl 调用 方法 : #session.cart.showcart0 访 问 不 到 ? 
网 络 课堂 : http://bbs.itzen.comy/thread-11002-1-1.html 


我 用 的 是 Struts 2, 一 个 类 放 在 session 中 , 想 用 ognl 调用 这 个 方法 :#session.cart. showcart()， 
但 访问 不 到 ， 不 知道 是 怎么 回 事 ? 

给 出 错误 Warming， 如 下 所 示 。 

[com.opensymphony.xwork2.ogn1.0gnlValueStack] Could not find method 

[#session.cart.showcart ()] 

从 错误 中 可 以 看 出 , session 里 有 这 个 类 {cart=com.shoppingcart.service.impl. Cart@1999b96} 
但 就 是 访问 不 到 这 个 Cart 里 面 的 方法 。 请 高 手 帮忙 解答 。 

【解决 办 法 】: 这 个 错误 意思 是 ， 在 Servlet 中 运行 service 方法 调用 method 时 ， 找 不 到 所 
调用 的 method(#session.cart.showcart0))， 你 这 个 方法 是 个 内 部 方法 ， 在 外 面 调用 不 到 ! 因此 会 
报错 ! 也 有 可 能 是 方法 名 大 小 写 问 题 。 


md) >> 


第 7 章 Struts 2 中 完整 的 OGNL 已 


7.5.3 ”后台 报错 : Caught OgnlException while setting property 'operate 


Result on type 怎 么 回 事 


后 台 报错 : Caught OgnlException while setting property 'operateResult on type 是 怎 
么 回 事 ? 

网 络 课堂 : http://bbs.itzen.com/thread-11004-1-1.html 

遇 到 了 一 个 很 棘手 的 OGNL 异常 问题 ， 后 台 报错 输出 如 下 。 


Caught OgnlException while setting property 'operateResult' on type 
"org.apache.struts2.dispatcher.ServletActionRedirectResult'. 


ognl.NoSsuchPropertyException: 
org.apache.struts2.dispatcher.ServletActionRedirectResult .operateResult 

at ognl.ObjectPropertyAccessor.setProperty (ObjectPropertyAccessor.java:132) 
at 

com.opensymphony .xwork2.util.0gnlValueStack$ObjectAccessor.setProperty (Ognl 
ValueStack.java:82) 

at ognl.OgnlRuntime.setProperty (OgnlRuntime.java:1656) 

at ognl.ASTProperty.setValueBody (ASTProperty.java:101 

at ognl.SimpleNode.evaluateSetValueBody (SimpleNode.java:177) 

at ognl.SimpleNode.setValue (SimpleNode.java:246) 

at ognl.0gnl.setValue (Ogn]l .java:476) 

at com.opensymphony .xwork2 .util.OgnlUtil.setValue (OgnlUtil.java:186) 

at 

com.opensymphony .xXwork2.util.O0gnlUtil.internalSetProperty (OgnlUtil .java:360) 
at com.opensymphony .xwork2.util.O0gnlUtil.setProperties (OgnlUtil.java:76) 

at 

com.opensymphony .xwork2.0bjectFactory.buildResult (ObjectFactory.java:222) 
at 

com.opensymphony .Xxwork2.DefaultActionInvocation.createResult (DefaultActionI 
nvocation.java:195) 


下 面 是 struts.xml 配置 文件 里 的 内 容 。 


<action name="UnlockEnterprise" 


class="com.baosight .worksheetmanagement .action.WorksheetEnterpriseUnlockAct 
ion"> 

<result name="success">/jsp/success.jsp</result> 

<result name="fail">/jsp/error.jsp</result> 

<result name="worksheetUnlockAction™" type="redirectAction"> 

<param name="actionName">worksheetUnlock</param> 

<param name="operateResult">${operateResult}</param> 

<param name="operate">success</param> 

</result> 
</action> 
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上 面 配置 的 operateResult 有 相应 的 get、set 方法 。 请 问 此 问题 如 何 解决 ， 产 生 的 原因 是 


什么 。 


【解决 办 法 】: 你 用 的 ResultType 是 redirectAction， 这 是 进行 浏览 器 的 重 定向 ， 并 且 重 定 


向 到 的 是 一 个 Action。 


当 UnlockEnterprise 的 Action 返回 的 “worksheetUnlockAction” 的 视图 时 ， 客 户 端的 浏览 


器 就 会 重新 发 出 一 个 请 求 ， 即 在 地 址 栏 中 可 以 看 到 。 


XXXX.action?operateResult=YYYYY&operate=success; 
其 中 的 XXXX 就 是 UnlockEnterprise 的 返回 的 视图 中 的 。 


<param name="actionName">worksheetUnlock</param> 


YYYYY 如 下 所 示 。 
<param name="operateResult">${operateResult}</param> 


应 该 将 type 配 成 "chain"。 代 码 没 问题 ,此 问题 属于 配置 文件 的 问题 , 仔细 检查 配置 文件 有 


没有 配置 出 错 ， 或 者 换个 ognl 包 。ognl.NoSuchPropertyException:org.apache.struts2.dispatcher. 
ServletActionRedirectResult.operateResult， 也 可 能 是 Struts 2 的 问题 。 


7.5.4 JSP 脚 本 在 Struts 2 中 利用 OGNL 和 标签 如 何 表示 


JSP 脚本 在 Struts 2 中 利用 OGNL 和 标签 如 何 表示 ? 
网 络 课堂 : http:Wbbs.itzcn.comy/thread-11008-1-1.html 


本 人 初学 Struts 2， 对 OGNL 也 是 一 无 所 知 ， 听 说 OGNL 表达 式 功能 强大 ， 所 以 想 问 一 下 


如 果 有 如 下 一 句 JSP 脚本 。 
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<%=prs.getToolBar ("/zsw/user.do?method=getlist")%> 
利用 Struts 2 中 的 OGNL 和 标签 如 何 表 示 ? 
【解决 办 法 】: 你 的 prs 是 什么 ? 
如 果 是 Action 中 的 方法 的 话 ， 那 么 在 Struts 2 标签 中 可 以 直接 使 用 ， 例 如 下 面 所 示 。 
<s:property value="getToolBar('....')"/> 
如 果 是 某 类 的 静态 方法 ， 可 以 这 么 调用 。 
<s:property value="@ 类 名 (完整 ) 8 方法 名 (或 者 属性 名 ) "/> 
以 上 是 OGNL 表达 式 对 方法 的 调用 。 


一 、 填 空 题 
(1) OGNL 三 要 素 : 表达 式 (Exception)、 和 上 下 文 环境 (Context)。 
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(2) OGNL 支持 的 常量 类 型 有 : 字符 囊 常量 、 字 符 常 量 、 、 布 尔 常量 和 null 
常量 。 

(3) OGNL 表达 式 中 的 in 和 notin 操作 符 的 作用 : : 

(4) OGNL 有 一 个 简化 的 lambda 表达 式 语法 ， 能 够 让 你 写 一 些 简 单 的 功能 。 定 义 lambda 
表达 式 的 语法 是 

二 、 选 择 题 

(1) 假如 有 一 个 employee 对 象 作为 OGNL 上 下 文 的 根 对 象 ， 那 么 访问 employee 对 象 的 
name 属性 ， 下 列表 达 式 哪个 正确 ? 


A. name B. #employee.name 

C. #name D. employee.getName() 
(2) 下 列 对 象 哪些 是 Struts 2 中 的 命名 对 象 ? 

A. page B. exception 

C. parameter D. application 
(3) Stmts 2 在 OGNL 基础 上 的 增强 有 哪些 ? 

A， 值 栈 (ValueStack) B. EL 表达 式 

C. NN 语法 D. lambda 表达 式 


(4) 使 用 lambda 表达 式 写 一 个 斐 波 那 契 函数 ， 下 面 哪个 正确 ? 
A. fib=:[#this==0?0:#this==1?1:#fib(#this-2)+fib(#this-1)] 
B. #fib=:[this==0?0:this==1?1:fib(this-2)+fib(this-1)] 
C. #fib=:[#this==0?0:#this==1?1:#fib(#this-2)+#fib(#this-1)] 
D. fib=:[this==0?0:this==1?1:fib(this-2)+fib(this-1)] 


、 上 机 练习 


上 机 练习 : 筛选 出 班 里 成 年 的 学 生 。 

本 次 上 机 练习 要 求 : 首先 封装 一 个 Student 学 生 实体 类 ， 包 含 两 个 属性 name 和 age。 然 后 
创建 一 个 StudentAction， 在 该 Action 中 声明 一 个 List 列表 存储 Struts 对 象 。 最 后 新 建 一 个 
student.jsp 页 面 在 该 页 面 中 应 用 OGNL 对 集合 操作 的 知识 ， 依 次 筛选 出 班 里 成 年 学 生 的 信息 ， 
显示 在 页 面 上 。 

最 终 运行 后 ， 执 行 输出 结果 如 图 7-9 所 示 。 


- 回 - 入 - 汪 IEBO-DIRO- " 


移 1T 精 英 班 


成 年 的 平生 各 下 -二 


ae D4 
所 和 将 生 
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内 容 摘 要 : 


一 个 MVC 框架 ， 重 点 是 实现 两 部 分 : 控制 器 部 分 和 视图 部 分 。Struts 2 框架 同样 也 把 重点 
放 在 了 这 两 个 部 分 : 控制 器 部 分 是 由 Action( 以 及 隐藏 的 系列 拦截 器 ) 来 提供 支持 的 ， 视 图 部 分 
则 通过 大 量 的 标签 来 提供 支持 。 

Struts 2 提供 的 标签 库 功 能 非常 强大 ， 而 且 非 常 好 用 。 使 用 标签 来 开发 ， 可 以 使 页 面 更 加 
整洁 容易 维护 ,减少 代 码 量 以 及 开发 时 间 。 本 章 介绍 了 标签 库 的 用 法 ， 包 括 如 何 通过 标签 库 来 
改进 JSP 页 面 的 数据 显示 ， 和 使 用 主题 、 模 板 支持 ， 如 何 简化 视图 页 面 的 编写 等 。 下 面 将 详细 
地 讲解 Struts 2 标签 库 各 方面 的 使 用 。 

学 习 目 标 : 

@ 掌握 标签 的 语法 。 
熟练 数据 标签 和 控制 标签 的 使 用 。 
掌握 模板 和 主题 。 
熟练 表单 标签 的 使 用 。 
理解 非 表单 标签 。 
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8.1 演员 年 龄 的 排序 


Struts 2 提供 的 非 UI 标 签 包括 控制 标签 和 数据 标签 , 主要 用 于 完成 流程 控制 和 对 ValueStack 
的 控制 。 数 据 标签 主要 用 于 访问 ValueStack 中 的 数据 ， 控 制 标签 可 以 完成 输出 流程 控制 。 本 节 
将 详细 讲解 控制 标签 的 应 用 。 


cc 视频 教学 : 光盘 /videos/08/iterator.avi 侠 长 度 : 6 分 名 
光盘 /videos/08/append.avi 国 长 度 : 7 分 名 
光盘 /videos/08/generator.avi 图 长 度 : 6 分 名 
光盘 /videos/08/ subset.avi 加 长 度 : 9 分 钟 
光盘 /videos/08/ sort.avi @ 长 度 : 5 分 名 


8.1.1 基础 知识 一 一 控制 标签 
控制 标签 可 以 完成 输出 流程 控制 ， 例 如 分 支 、 循 环 等 操作 ; 也 可 完成 对 集合 的 合并 、 排 序 
等 操作 。 控 制 标 签 有 : 过 、elself/elseif、else、append、generator， 等 等 ， 关 于 它们 的 讲解 如 下 。 
1.if/elseif/else 标 签 


if/elseif/else 这 三 个 标签 都 是 用 于 分 支 控 制 的 ， 它 们 都 用 于 根据 一 个 Boolean 表达 式 的 值 ， 
来 决定 是 否 计算 、 输 出 标签 体 的 内 容 。 
这 三 个 标签 可 以 结合 使 用 ，<s:if .…. 人 > 标签 可 以 单独 使 用 ， 但 <s:elseif .…./> 和 <s:else .…/> 都 
不 可 单独 使 用 ， 必 须 与 <s:if ... 记 结合 使 用 。<s: 让 ... 记 标签 可 以 与 多 个 <s:elseif ... 人 标签 结合 使 
用 ， 并 可 以 结合 一 个 <s:else .…. 人 > 标签 使 用 。 三 个 标签 结合 使 用 的 语法 格式 如 下 所 示 。 
<s:if test=" 表 达 式 "> 
标签 体 

</Bs 人 FE 

<s:elseif test=" 表 达 式 "> 
标签 体 

</s:elseif> 


<!-- 允许 出 现 多 次 elseif 标签 --> 
<auelIe 
标签 体 
</sselse> 
上 面 的 违 elseigelse 三 个 标签 组 合 ， 对 应 了 Java 语言 里 的 if{}else{} 分 支 结构 。 
2. iterator 标 签 
iterator 标签 主要 用 于 集合 的 迭代 ， 这 里 的 集合 包含 List、Set 和 数组 ， 也 可 对 Map 类 型 的 
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对 象 进行 迭代 输出 。 
使 用 <s:iterator.…./> 标 签 对 集合 进行 迭代 输出 时 ， 可 以 指定 如 表 8-1 中 的 三 个 属性 。 
表 8-1 iterator 标 签 属性 
说 明 
指定 被 迭代 的 集合 , 如 果 没 有 指定 value 
属性 ， 则 使 用 ValueStack 栈 顶 的 集合 


value i String 


Collection 、 Map 、 
id Enumeration Iterator | 指定 集合 里 元 素 的 id 


或 者 Array 


指定 迭代 时 的 IteratorStatus 实例 ， 通 过 
该 实例 即 可 判断 当前 和 迭代 元 素 的 属性 。 
例如 是 否 是 最 后 一 个 ， 以 及 当前 迭代 元 
素 的 索引 等 


Status 


如 果 为 status 属性 指定 一 个 值 ， 将 创建 一 个 org.apache.struts2.views.jsp.Iterator 
注意 Status 实例 。 


IteratorStatus 类 中 有 如 下 的 方法 。 
@ public int getCount0: 获取 当前 迭代 的 元 素 的 总 数 。 
public int gettmdex0: 获取 当前 迭代 的 元 素 的 索引 。 
public boolean isEven0: 判断 当前 迭代 的 元 素 的 顺序 是 否 是 偶数 。 
public boolean isOdd0: 判断 当前 迭代 的 元 素 的 顺序 是 否 是 奇数 。 
public boolean isFirst0: 判断 当前 和 迭代 的 元 素 是 否 是 第 一 个 元 素 。 
public boolean isLast(): 判断 当前 迭代 的 元 素 是 否 是 最 后 一 个 元 素 。 
通过 上 面 几 个 方法 ， 可 以 在 迭代 时 ,根据 当前 迭代 元 素 的 属性 ， 来 进行 更 多 的 控制 ， 下 面 
通过 这 些 属性 和 iterator 标签 来 欠 代 显示 节日 集合 ， 代 码 如 下 所 示 。 
<table border="0" > 
<s:iterator value="{' 端 午 节 ',' 中 秋 节 ', ' 七 夕 节 ',' 重 阳 节 '}" id="name" 
status="status"> 
<tr <s:if test="#status.odd">style="background-color:red"</s:if>> 
<td><s:property value="#status.count"/><s:property 
value="name"/></td> 
</tr> 
</s:iterator> 
</table> 


3. append 标 签 
append 标签 可 以 将 多 个 集合 对 象 拼 接 起 来 ,组 成 一 个 新 的 集合 。 通 过 这 种 拼接 ， 人 允许 通过 
-个 <s:iterator .…./> 标 签 就 完成 对 多 个 集合 的 迭代 。 
append 标签 可 以 指定 一 个 id 属性 ， 如 果 指定 了 该 属性 ， 那 么 组 合 后 的 迭代 器 将 被 保存 到 
OgnlContext 中 ， 可 以 通过 该 属性 的 值 来 引用 组 合 后 的 迭代 器 。 


< 
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当 使 用 <s:append .…. 亿 标签 时 ， 需 要 指定 一 个 id 属性 ， 该 属性 确定 拼接 生成 的 新 集合 的 名 
字 。 除 此 之 外 ，<s:append ... 人 > 标签 还 可 以 接受 多 个 <s:param ... 往 子 标签 ， 每 个 子 标签 指定 一 个 
合 ，<s:append ... 人 > 标签 负责 将 <s:param .…/> 标 签 指定 的 多 个 集合 拼接 成 一 个 集合 。 
下 面 使 用 append 标签 将 两 个 集合 拼接 成 一 个 新 集合 ， 然 后 使 用 iterator 标签 对 新 集合 进行 
和 友 代 。 例 子 如 下 代码 。 
<!-- 使 用 append 标签 将 两 个 集合 拼接 成 新 的 集合 ， 新 集合 的 名 字 是 day --> 


<s:append id="day"> 
<s:param value="{' 端 午 节 '，,' 中 秋 节 ', ' 七 夕 节 ',' 重 阳 节 '}" /> 
<s:param value="{' 元 旦 ', ' 春 节 '}" /> 
</s:append> 
<table border="0" > 
<s:iterator value="#day" status="status"> 
<!-- 对 新 集合 进行 迭代 ， 使 用 status 属性 --> 
<tr <s:if test="#status.odd">style="background-color:red"</s:if>> 
<td><s:property/></td> 


</tr> 
</s:iterator> 
</table> 
4. merge 标 签 


merge 标 签 的 用 法 看 起 来 与 append 标 签 非常 像 , 它 也 是 用 于 将 多 个 集合 拼接 成 一 个 新 集合 。 
它们 的 区 别 就 是 对 合并 后 的 迭代 器 中 的 元 素 迭 代 的 顺序 不 一 样 。 

假如 有 三 个 迭代 器 被 合并 ， 每 一 个 迭代 器 有 三 个 元 素 ， 下 面 是 使 用 merge 标签 合并 后 的 迭 
代 器 中 的 元 素 被 迭代 的 顺序 ， 如 图 8-1 所 示 。 


图 8-1 _ merge 标签 合并 后 的 迭代 器 的 元 素 迭 代 顺 序 
下 面 是 使 用 append 标签 合并 后 的 迭代 器 中 的 元 素 被 迭代 的 顺序 ， 如 图 8-2 所 示 。 
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8-2 append 标 签 合并 后 的 迭代 器 中 元 素 被 和 迭代 的 顺序 


merge 标签 有 一 个 id 属性 ,如 果 指 定 了 oi a Ds 素 
可 以 通过 该 属性 的 什 来 引用 合并 后 的 迁 代 器 。 | 几 系 
通过 一 个 小 程序 ， 看 看 merge 标签 是 如 何 来 拼接 多 个 集合 的 ， 代 码 如 下 所 示 。 
<s:merge id="mergeday"> 
<s:param value="{' 元 宵 节 '，,' 清 明 节 ' } "></s:param> 
<s:param value="{' 端 午 节 ',' 中 秋 节 ', ' 七 夕 节 ', ' 重 阳 节 ' }" /> 
<s:param value="{' 元 旦 ',' 春 节 '}" /> 
</s:merge> 
<table border="0" > 
<s:iterator value="#mergeday" status="status"> 
<tr <s:if test="#status.odd">style="background-color:red"</s:if>> 
<td><s:property/></td> 
</tr> 
</s:iterator> 
</table> 


上 述 代 码 使 用 merge 标签 ， 将 三 个 节日 集合 拼接 成 为 一 个 新 集合 ， 并 通过 iterator 标签 依 
次 显示 在 表格 中 。 


5. generator 标 签 第 个 元 素 


generator 标签 根据 separator 属性 指定 的 分 隔 符 ， 将 val 属性 指定 的 值 进行 拆 分 ， 然 后 生成 
-个 迭代 器 ， 压 入 到 值 栈 的 栈 顶 。 在 generator 标签 的 内 部 ， 可 以 使 用 iterator 标签 取出 栈 项 的 
迭代 器 对 拆 分 后 的 各 个 部 分 进行 迭代 。 当 generator 标签 结束 时 ， 栈 项 的 迭代 器 将 被 删除 。 也 
可 以 这 样 理 解 : generator 将 一 个 字符 串 转化 成 一 个 集合 。 在 该 标签 的 内 部 ， 整 个 临时 生成 的 集 
合 将 位 于 ValueStack 的 顶端 ， 一 旦 该 标签 结束 ， 该 集合 将 被 移出 ValueStack。 
generator 标签 的 属性 如 表 8-2 所 示 。 


3 


< 寺 一 


表 8-2 generator 标签 的 属性 


属性 名 称 | 是 否 必需 | 默 认 值 类 型 说 阴 
val 是 无 String 指定 要 解析 的 值 
separator 是 无 String 指定 用 于 解析 val 属性 的 分 隔 符 
Ee 否 无 ee oa 的 元 素 
es 否 无 org.apache.struts2.util .Iterator 指定 一 个 转换 器 ， 用 于 将 解析 后 的 
Ee Generator.Converter 各 个 字符 串 转换 为 对 象 
如 果 指 定 了 该 属性 ， 那 么 生成 的 选 
id 否 无 String 代 器 将 以 该 属性 的 值 为 key 保存 到 
pageContext 对 象 中 


下 面 的 代码 使 用 generator 标签 生成 一 个 简单 的 集合 。 


<table border="0" > 


详细 代码 如 下 所 示 。 


<!-- 使 用 s:generator 标签 将 一 个 字符 串 解析 转换 成 一 个 集合 --> 
<s:generator val="' 端 午 节 , 中 秋 节 ,七 夕 节 , 重阳 节 '" separator=","> 
<!-- 在 generator 标签 内 ， 该 集合 位 于 Valuestack 的 栈 顶 ， 故 此 处 迭代 就 是 临时 生成 


<s:iterator status="status"> 


<!-- 根据 当前 迭代 项 索引 的 奇偶 来 决定 是 否 使 用 css 样式 --> 


EE 


test="#status.odd">style="background-color:red"</s:if>> 


<td><s:property /></td> 
</tr> 
</s:iterator> 
</s:generator> 
</table> 


6. subset 标 签 


subset 标签 用 于 取得 集合 的 子 集 , 该 标签 的 底层 通过 org.apache.Struts2.util.SubsetIteratorFilter 


类 提供 实现 。 
使 用 subset 标签 时 ， 可 以 指定 的 属性 如 表 8-3 所 示 。 


表 8-3 ” subset 标签 属性 


属性 名 称 说 明 
Se ee 指定 子 集中 元 素 的 个 数 。 如 果 不 指定 该 
属性 ， 默 认 取得 源 集合 的 全 部 元 素 
Collection、 Map、Enumeration、| 指定 源 集合 。 如 果 不 指 定 该 属性 ， 默 认 
ONES Iterator 或 者 Array 取得 ValueStack 栈 顶 的 集合 
指定 子 集 从 源 集合 的 第 几 个 元 素 开 始 截 
Start Integer 取 。 默 认 从 第 一 个 元 素 ( 即 start 的 默认 值 
为 9) 开 始 截 取 
ee po ste SubsetIte 指定 有 开发 者 自己 决定 是 否 选中 该 元 素 
ratorFilter.Decider 
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下 面向 读者 讲解 一 个 小 案例 。 在 这 个 案例 中 ， 使 用 subset 元 素 先 指定 source 属性 源 集合 ， 
然后 指定 start 属性 为 2， 即 标签 子 集 从 源 集 合 的 第 三 个 元 素 开 始 截 取 ， 最 后 指定 count 属性 为 
4， 表 明 自 己 的 长 度 为 4。 代 码 如 下 所 示 。 

<table border="0" > 


<!-- 使 用 s: subset 标签 截取 目标 集合 的 四 个 元 素 ， 从 第 二 个 元 素 开始 截取 --> 
<s:subset source="{ ' 春 节 '，' 元 宵 节 '，' 清明 节 ' ，' 端午 节 ' ，' 五 一 劳动 节 '"，' 中 秋 节 ' }" 


start="2" count="4"> 

<!-- 使 用 iterator 标签 来 迭代 目标 集合 ， 因 为 没有 指定 value 属性 值 ， 故 迭代 
Valuestack 栈 

顶 的 元 素 --> 


<s:iterator status="status"> 
<!-- 根据 当前 迭代 项 索引 的 奇偶 来 决定 是 否 使 用 css 样式 --> 
EE 
test="#status.odd">style="background-color:red"</s:if>> 
<td><s:property /></td> 
</tr> 
</s:iterator> 
</s:subset> 
</table> 


在 subset 标签 内 部 时 ，subset 标签 生成 的 子 集 放 在 ValueStack 的 栈 顶 ， 如 果 该 标 


注意 签 结束 后 ， 该 标签 生成 的 子 集 将 被 移出 ValueStack 栈 。 
7. sort 标 签 


sort 标签 用 于 对 指定 的 集合 元 素 进行 排序 。 进 行 排序 时 ， 必 须 提 供 自 身 的 排序 规则 ， 即 使 
实现 自己 的 Comparator，Comparator 也 需要 实现 java.util.Comparator 接口 。 
使 用 sort 标签 时 ， 可 以 指定 如 表 8-4 中 的 属性 。 


表 8-4 sort 标 签 属性 
属性 名 称 和 说 明 
comparator java.util.Comparator “| 指定 进行 排序 的 Comparator 实例 
Collection 、 Map 、 下 
指定 被 排序 的 集合 。 如 果 不 指 定 该 属性 ， 则 
source Enumeration、Iterator 


对 ValueStack 栈 顶 的 集合 进行 排序 


或 者 Arra: 
下 面 封装 一 个 Comparator， 代 码 如 下 所 示 。 


public class SortComparator implements Comparatort{ 


public int Object e2) { 


String 


compare (Object el, 
strl = (String)el; 
Str2 = 


String 
return 


(String)e2; 
strl.compareTo (str2); 


< 针 一 
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实现 比较 器 SortComparator， 需 要 实现 一 个 Comparator 接口 ， 并 实现 它 的 compare(Object 
args1,Object args2) 方 法 。 如 果 该 方法 返回 一 个 大 于 0 的 整数 ， 则 第 一 个 元 素 大 于 第 二 个 元 素 ; 
如 果 该 方法 返回 0， 则 两 个 元 素 相等 ， 如 果 该 方法 返回 小 于 0 的 整数 ， 则 第 一 个 元 素 小 于 第 二 
个 元 素 。 

下 面 代 码 使 用 <s:bean> 标 签 引 入 比较 器 SortComparator， 然 后 使 用 <s:sort> 标 签 将 指定 的 源 
集合 进行 排序 。 代 码 如 下 所 示 。 

<!-- 使 用 bean 标签 定义 一 个 comparator 实例 --> 


<s:bean name="com.struts2.tags.SortComparator" id="sortComparator"></s:bean> 
<table border="0"> 
<!-- 使 用 自 定义 的 排序 规则 对 目标 集合 进行 排序 --> 
<s:sort source="{' 端 午 节 ',' 中 秋 节 ', ' 七 夕 节 ', ' 重 阳 节 ' }" 
comparator="#sortComparator"> 
<!-- 和 迭代 输出 集合 --> 
<s:iterator> 
<tr><td><s:property/></td></tr> 
</s:iterator> 
</s:sort> 
</table> 


8.1.2 ”实例 描述 


之 前 如 果 想 在 JSP 页 面 中 动态 控制 页 面 的 输出 信息 ， 需 要 在 页 面 中 添加 JSP 脚本 ,但 这 样 
使 页 面 中 分 布 了 很 多 Java 代码 ， 使 人 看 起 来 很 凌乱 。Struts 2 的 标签 库 提供 了 控制 标签 ， 使 用 
这 些 控制 标签 可 以 灵活 地 控制 页 面 的 输出 内 容 。 本 节 实 例 为 读者 显现 的 是 ， 如何 使 用 控制 标签 
实现 演员 的 年 龄 排序 。 


8.1.3 ”实例 应 用 


【 例 8-1】 演员 年 龄 的 排序 。 
(1) 在 项 目 目录 src/com.struts2.domain 下 ， 新 建 一 个 Actor 类 ， 声 明 三 个 属性 name、sex 
和 age。 并 分 别 给 出 这 三 个 属性 的 get、set 方法 。 代 码 如 下 所 示 。 


public class Actor { 


private String name; // 名 称 
private String sex; // 性 别 
private int age; // 年 龄 


// 下 面 是 name、sex 和 age 属性 的 get 和 set 方法 ， 在 此 省 略 了 。 
X/ 
} 


(2) 在 项 目 目 录 src/com.struts2.action 下 新 建 一 个 ActorAction 类 ， 声 明 一 个 演员 列表 ， 并 
重 写 继承 于 ActionSupport 类 的 execute0 方 法 ， 代 码 如 下 所 示 。 
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public class ActorAction extends ActionSupport{ 
private List<Rctor> actors = new ArrayList<Actor>();  // 演 员 列 表 对 象 


public List<Actor> getActors() { 
return actors; 


public void setActors(List<Actor> actors) { 
this.actors = actors; 


public String execute () throws Exception{ 

// 下 面向 演员 列表 actors 中 添加 演员 对 象 
actors.add (new Actor (" 李 璐 囊 ", 26) ) ; 
actors.add (new Actor(" 郭 晓 静 ", 32) ) ; 
actors.add (new Rctor(" 刘 晶 晶 ",35)) 7 
actors.add (new Rctor(" 肖 庆 宇 ",38) ); 
actors.add (new Rctor(" 周 丽 丽 ",21) ) 
actors.add (new Rctor(" 武 小 倩 ",13)) 7 
return "success"; 


} 


(3) 打开 项 目 目录 src 下 的 struts.xml 文件 ， 在 该 文件 中 添加 ActorAction 的 配置 ， 代 码 如 
下 所 示 。 
<package name="controltag" extends="struts-default"> 
<action name="actor" class="com.struts2.action.ActorAction"> 
<result>/actor.jsp</result> 
</action> 
</package> 


(4) 在 项 目 目录 src/comparator 下 新 建 一 个 比较 演员 年 龄 的 比较 器 类 SortComparator.java， 
该 类 实现 Comparator 接口 ， 并 实现 该 接口 的 compare() 方 法 ， 对 演员 的 年 龄 进行 比较 ， 代 码 如 
下 所 示 。 

public class SortComparator implements Comparatort{ 

public int compare (Object el，object e2) { // 比 较 演员 对 象 


Actor actorl= (Actor)el; // 转 换 成 Actor 对 象 
Actor actor2= (Actor)e2; 


Integer intl = actorl.getAge(); // 获 取 演 员 对 象 的 年 龄 


Integer int2 = actor2.getAge(); 


return intl.compareTo (int2); // 比 较 两 个 演员 对 象 的 年 龄 大 小 


} 


(5) 新 建 一 个 actorjsp 页 面 , 在 该 页 面 中 使 用 iterator 标签 显示 演员 信息 。 然 后 使 用 <bean> 
标签 导入 比较 器 SortComparator 类 实例 。 最 后 使 用 <sort> 标 签 比 较 年 龄 大 小 ， 并 按 年 龄 从 小 到 
大 排序 显示 。 代 码 如 下 所 示 。 


< 
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<h3><span> 演 员 列表 如 下 : </span></h3> 
<p> 
<table> 
<s:iterator value="actors" id="name" status="status"> 
<tr <s:if test="#status.odd">style="background-color:yellow"</s:if>> 
<td><s:property value="#status.count"/><s:property 
value="name"/></td> 
</Er 
</s:iterator> 
</table> 
</p> 
<h3><span> 演 员 年 龄 排序 如 下 : </span></h3> 
<p> 
<!-- 使 用 bean 标签 定义 一 个 comparator 实例 --> 
<s:bean name="comparator.SortComparator" id="sortComparator"></s:bean> 
<table border="0"> 
<!-- 使 用 自 定义 的 排序 规则 对 目标 集合 进行 排序 --> 
<s:sort source="actors" comparator="#sortComparator"> 
<!-- 友 代 输出 集合 --> 
<s:iterator> 
4 
<td><s:property value="name"/></td> 
<td> 年 龄 : <s:property value="age"/></td> 
</tr> 
</s:iterator> 
</s:sort> 
</table> 
</p> 


8.1.4 运行 结果 


打开 正 浏 览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_8/actor.action”， 执 行 效果 
如 图 8-3 所 示 。 


演员 年 龄 排序 


入 内 列表 旭 下 / 


bry 


演员 年 动 圭 序 各 下; 


8-3 ”演员 年 龄 排序 
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8.1.5 实例 分 析 


a 


上 述 实 例 中 ， 首 先 封 装 了 一 个 演员 实体 类 Actor， 包 含 三 个 属性 name、sex 和 age。 

然后 创建 了 一 个 ActorAction， 在 该 Action 中 声明 一 个 演员 列表 对 象 ， 并 向 该 列表 对 象 中 
添加 了 Actor 对 象 。 

最 后 创建 了 一 个 演员 年 龄 比较 器 类 SortComparator 和 一 个 actor.jsp 页 面 ， 在 actorjsp 页 面 
中 使 用 <bean> 标 签 导 入 SortComparator 类 实例 ， 并 使 用 <sort> 标 签 将 演员 年 龄 按 从 小 到 大 排序 
显示 。 


8.2 ”显示 学 员 信 息 


上 节 详 细 讲 解 了 控制 标签 的 使 用 ， 相 信 读 者 对 控制 执行 流程 分支、 循环 等 操作 ) 应 该 应 用 
自如 了 。 本 节 将 学 习 如 何 使 用 数据 标签 访问 值 栈 中 的 数据 。 


< 如 视频 教学 : 光盘 /videos/08/property.avi 人 @ 长 度 : 5 分 钟 
光盘 /videos/08/set.avii @ 长 度 : 6 分 钟 
光盘 /videos/08/push.avi @ 长 度 : ;5 分钟 
光盘 /videos/08/param.avi 人 @@ 长 度 : ;5 分钟 
光盘 /videos/08/bean avi 人 @ 长 度 : 5 分 钟 
光盘 /videos/08/action avi 人 @@ 长 度 : 9 分 钟 
光盘 /videos/08/include.avi 人 长 度 : 4 分 名 
光盘 /videos/08/url.avi @ 长 度 : 8 分 钟 
光盘 /videos/08/date.avi @ 攻 度 : 7 分 钟 


8.2.1 基础 知识 一 一 数据 标签 

数据 标签 用 于 访问 ActionContext 和 值 栈 中 的 数据 ,数据 标签 有 : property、 set、 push、 param， 
等 等 ， 它 们 的 功能 简介 以 及 使 用 方法 如 下 。 

1. property 标 签 


property 标签 的 作用 是 输出 value 属性 指定 的 值 ， 如 果 没 有 指定 value 属性 ， 则 默认 输出 
ValueStack 栈 顶 的 值 。 使 用 该 标签 可 以 指定 如 表 8-5 所 示 的 属性 。 
property 标签 用 法 比较 简单 , 在 上 节 的 实例 中 已 经 大 量 使 用 到 了 它 , 在 此 来 看 一 个 小 例子 。 


<s:property value="day"” default=" 七 夕 节 "/> 


取出 栈 项 对 象 (通常 是 Action) 的 day 属性 并 输出 , 如 果 没有 找到 day 属性 , 则 输出 “七 夕 节 ”。 


< 
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表 8-5 property 标 签 属性 
说 明 
如 果 需 要 输出 的 属性 值 为 null， 则 显示 的 
default 属性 指定 的 值 
escape Boolean 指定 是 否 escape HTML 代码 
指定 需要 输出 的 属性 值 ， 如 果 没 有 指定 该 属 
性 ， 则 默认 输出 ValueStack 栈 顶 的 值 
id : String 指定 该 元 素 的 标识 


default 


value 9 Object 


2. set 标 签 

set 标签 用 于 将 某 个 值 放 入 指定 范围 内 ， 例 如 application 范围 、session 范围 等 。set 标签 在 
某 些 情况 下 是 比较 有 用 的 ， 例如， 在 页 面 中 多 次 引用 一 个 复杂 的 表达 式 ， 并 将 这 个 表达 式 赋 给 
-个 变量 ， 然 后 直接 引用 变量 。 使 用 set 标签 的 好 处 有 两 个 。 

(1) 提高 了 代码 的 可 读 性 。 

(2) 提升 了 性 能 (表达 式 的 计算 只 有 一 次 )。 

set 标签 的 属性 如 表 8-6 所 示 。 

表 8-6 set 标签 属性 


属性 名 称 说 明 
Eg 重新 生成 的 新 变量 的 名 字 
指定 将 赋 给 变量 的 值 。 如 果 没有 指定 该 属性 ， 则 


ue 权 顶 对 象 | Object 。 | 将 Valuestack 校 项 的 值 赋 给 新 变量 
scope Action 
application 


a Cm 指定 该 元 素 的 引用 ID 


使 用 set 标签 可 以 理解 为 定义 一 个 新 变量 ， 且 将 一 个 已 有 的 值 复制 给 新 变量 ， 并 且 
技巧 可 以 将 新 变量 放 到 指定 的 范围 内 。 
set 标 签 以 name 属性 的 值 作为 键 (key), 将 value 属 性 的 值 保存 到 指定 的 范围 对 象 中 (如 page、 
request 和 session 等 )。 属 性 scope 取 值 中 的 page、request、session 和 application 同 JSP 的 4 种 
范围 , 如 果 指 定 action 范围 默认 值 ), value 属性 的 值 将 被 同时 保存 到 request 范围 和 OgnlContext 
中 。 下 面 使 用 set 标签 ， 将 节日 对 象 放 到 指定 的 范围 内 ， 如 : request、session 和 application 等 ， 
并 将 它们 取出 显示 在 页 面 上 ， 代 码 如 下 所 示 。 


<s:bean name="com.struts2.domain.Festival" id="fest"> 


name 


<s:param name="name” value="' 端 午 节 '"/> 
<s:param name="desc"” value="' 为 了 纪念 届 原 ， 而 流传 下 来 的 节日 '"/> 
</s:bean> 


<!-- 默认 将 fest 保存 到 ognlcontext 中 --> 


mt > 
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<s:set value="#fest" name="XXX"/> 

<s:property value="#XXX.name"/><br/> 

<s:property value="#XXX.desc"/><br/> 

<!-- 将 fest 保存 到 application 范围 内 --> 

<s:set value="#fest" name="XXX" scope="application"/> 
<s:property value="#attr.XXX.name"/><br/> 
<s:property value="#attr.XXX.desc"/><br/> 

<!-- 将 fest 保存 到 session 范围 内 --> 

<s:set value="#fest" name="XXX" scope="session"/> 
${sessionSscope.XXX.name}<br/> 
${sessionSscope.XXX.desc}<br/> 


3. push 标 签 


push 标签 用 于 将 某 个 值 放 到 ValueStack 的 栈 项 , 从 而 可 以 更 简单 地 访问 该 值 。 使 用 该 标签 
时 可 以 指定 如 表 8-7 所 示 的 属性 。 


表 8-7 push 标 签 属性 


属性 名 称 
Value | 


push 标签 与 set 标签 的 区 别 在 于 ，set 标签 是 将 值 放 到 Action 上 下 文中 。 当 push 
注意 标签 结束 后 ，push 标签 放 入 值 栈 中 的 对 象 将 被 删除 。 换 句 话说 ， 要 访问 push 标签 
压 入 栈 中 的 对 象 ， 需 要 在 标签 内 部 去 访问 。 
如 果 对 某 个 对 象 操作 比较 频繁 ， 可 以 使 用 push 标签 将 这 个 对 象 压 入 值 栈 的 项 部 ， 随 后 针 
对 该 对 象 的 操作 就 可 以 简化 了 。 创 建 一 个 PushAction， 将 Festival 对 象 放 到 session 中 ， 代 码 如 
下 所 示 。 


public class PushAction extends ActionSupport { 

private Festival fest; 

public Festival getFest() { 
return fest; 

} 

public void setFest (Festival fest) { 
this.fest = fest; 

} 

public String execute() throws Exception { 
fest = new Festival(); 
fest.setName (" 重 阳 节 ") 
fest .setDesc (" 九 月 九 日 望 乡 台 ") ; 
ActionContext .getContext () .getSession() .put ("fest",fest); 
return "success"; 


< 


使 用 <s:property ... 人 > 标签 直接 来 访问 session 中 的 fest 对 象 , 也 可 以 使 用 push 标签 将 session 
中 的 fest 对 象 压 入 栈 顶 ， 以 便 访 问 ， 代 码 如 下 所 示 。 
<!-- 访问 session 中 的 fest 对 象 的 属性 --> 
节日 名 称 : <s:property value="#session.fest.name"/><br/> 
节日 描述 : <s:property value="#session.fest.desc"/><br/> 
<!-- 使 用 push 标签 将 session 中 的 fest 对 象 放 到 栈 顶 ， 便 于 访问 --> 
<s:push value="#session.fest"> 
节日 名 称 : <s:property value="name"/> 
节日 描述 : <s:property value="desc"/> 
</s:push> 


4. param 标 签 


param 标签 主要 用 于 为 其 他 标签 提供 参数 ， 例 如 : 为 append 标签 、merge 标签 、bean 标签 
和 include 标签 提供 参数 。param 标签 可 以 配置 如 表 8-8 所 示 的 属性 。 


表 8-8 param 标 签 属性 


属性 名 称 。 | 是否 必需 “| 默认 值 | 类 型 | 说 明 
半 关 | 


指定 需要 设置 参数 的 参数 名 
value | 厨 | 无 | ovieet | 指定 需要 设置 参数 的 参数 值 
ia | | 无 | swine。 | 指定 引用 该 元 素 的 ID 
其 中 ，value 属性 是 可 选 的 ， 因 为 <s:param .> 标签 有 两 种 用 法 。 
第 一 种 用 法 如 下 所 示 。 
<param name="username">Jack</param> 
在 上 面 的 用 法 中 ， 指 定 一 个 名 为 usemame 的 参数 ， 该 参数 的 值 为 Jack。 
第 二 种 用 法 如 下 所 示 。 
<param name="username" Value="Jack"/> 
在 上 面 的 用 法 中 ， 指 定 一 个 名 为 usemame 的 参数 ， 该 参数 的 值 为 Jack 对 象 的 值 一 一 如 果 
Jack 对 象 不 存在 , 则 usemame 参数 的 值 为 null。 如果 想 指 定 usemame 参数 的 值 为 Jack 字符 串 ， 
则 应 该 写 如 下 代码 。 


<param name="username" value="'Jack'"/> 
人 如 果 采 用 上 面 写 法 ， 又 希望 直接 传 入 字符 囊 值 ， 则 应 该 将 字符 囊 常 量 放 入 引号 中 。 


5. bean 标 签 


bean 标签 用 于 创建 一 个 JavaBean 实例 。 创 建 JavaBean 实例 时 ， 可 以 在 该 标签 体内 使 用 多 
个 param 标签 来 为 对 象 的 属性 (必须 有 相应 的 setter 方法 ) 注 入 值 。 如果 bean 标签 还 指定 了 id 属 
性 ， 则 创建 的 JavaBean 对 象 将 被 放 入 OgnlContext 中 。 
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bean 标签 的 属性 如 表 8-9 所 示 。 
表 8-9 bean 标 签 属性 


属性 名 称 ”| 是 否 必 需 | 默认 值 | 类 型 说 明 
name 要 实例 化 的 JavaBean 的 完整 类 名 
id 指定 一 个 名 字 ， 用 于 引用 放 入 OgnlContext 中 的 
i 


JavaBean 对 象 


@ $ Id 属性 为 一 个 可 选 属性 ， 不 管 是 否 指 定 了 id 属性 ，bean 标签 创建 的 JavaBean 实 

注意 例 都 将 被 压 入 ValueStack 的 顶端 ,在 bean 标签 的 内 部 可 以 直接 访问 实例 化 的 对 象 ， 
不 用 使 用 “#” 标 记 。 但 一 旦 bean 标签 结束 了 ，bean 标签 创建 的 JavaBean 实例 将 
从 ValueStack 中 移 除 ， 这样 的 话 就 无 法 访问 到 该 JavaBean 实例 了 ,除非 指定 了 id 
属性 ， bean 标签 创建 的 JavaBean 实例 还 将 被 放 到 OgnlContext 中 ， 在 bean 标签 
的 外 部 ， 依 然 可 以 访问 创建 的 对 象 ， 不 过 此 时 需要 要 添加 “#” 标 记 。 


以 下 是 bean 标签 的 一 个 使 用 练习 。 这 个 练习 使 用 bean 标签 来 实例 化 一 个 节日 类 Festival， 
并 演示 bean 标签 不 指定 id 属性 与 指定 id 属性 的 区 别 。 代 码 如 下 所 示 。 
<h3>bean 标签 没有 指定 id 属性， 创建 的 Festival 实例 被 放 到 valuestack 的 顶部 </h3> 


<s:bean name="com.struts2.domain.Festival"> 
<s:param name="name" value="' 中 秋 节 '"/> 
<s:param name="desc"” value="' 中 秋 节 要 吃 月 饼 哦 '"/> 
节日 名 称 : <s:property value="name"/><br/><!-- 可 以 输出 name 属性 值 --> 
节日 描述 : <s:property value="desc"/><br/><!-- 可 以 输出 desc 属性 值 --> 


</s:bean> 


<p> 

节日 名 称 : <s:property value="name"/><br/><!-- Festival 对 象 已 从 栈 顶 移 除 ， 输 出 
为 null --> 

节日 描述 : <s:property value="desc"/><br/><!-- Festival 对 象 已 从 栈 顶 移 除 ， 输 出 
为 nul1--> 
</p> 
<h3>bean 标签 指定 了 id 属性 , 创建 的 Festival 实例 被 放 到 Valuestack 的 顶部 和 ogn1Context 
中 </h3> 


<s:bean name="com.struts2.domain.Festival" id="fest"> 

<s:param name="name" value="' 中 秋 节 '"/> 

<s:param name="desc"” value="' 中 秋 节 要 吃 月 饼 哦 '" /> 

节日 名 称 ，<s:property value="name"/><br/><!-- 可 以 输出 name 属性 值 --> 

节日 描述 : <s:property value="desc"/><br/><!-- 可 以 输出 desc 属性 值 --> 
</s:bean> 
<p> 

节日 名 称 : <s:property value="#fest.name"/><br/><!-- 可 以 输出 name 属性 值 --> 

节日 描述 : <s:property value="#fest.desc"/><br/><!-- 可 以 输出 desc 属性 值 --> 
</p> 


上 述 代码 中 没有 指定 id 属性 时 ， 创 建 的 Festival 对 象 只 被 压 入 值 栈 ， 在 bean 标签 的 内 部 
使 用 property 标签 可 以 直接 访问 Festival 对 象 的 name 和 desc 属性 。 在 bean 标签 的 外 部 ， 将 无 
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法 访问 Festival 对 象 的 属性 ， 因 为 此 时 值 栈 中 的 Festival 对 象 已 被 移 除 。 

在 指定 id 属性 时 , 创建 的 Festival 对 象 被 放 到 值 栈 和 Action 上 下 文中 , 因此 在 标签 的 内 部 
和 外 都 可 以 访问 Festival 对 象 的 属性 ， 只 不 过 在 标签 外 部 访问 时 需要 添加 #fest 作为 前 缀 。 

6. action 标 签 


通过 指定 Action 的 名 字 和 可 选 的 名 称 空间 ,action 标签 允许 在 JSP 页 面 中 直接 调用 Action。 
如 果 将 标签 的 executeResult 属性 设 为 true( 默 认为 false)， 那 么 Action 对 应 的 结果 输出 也 将 被 包 
含 到 本 页 面 中 。 


@ 如 果 为 action 标签 指定 了 id 属性 , 则 相应 的 Action 实例 将 被 放 到 OgnlContext 中 ， 
注意 在 action 标签 结束 后 ， 也 可 以 通过 #id 来 应 用 Action。 


在 action 标签 体 中 也 可 以 嵌 套 param 标签 ， 向 Action 传递 参数 。action 标签 的 属性 如 
表 8-10 所 示 。 


表 8-10 ”action 标 签 的 属性 
属性 名 称 | 默认 值 | 类 型 | 说 明 
该 属性 将 会 作为 该 Action 的 引用 ID 
指定 该 标签 调用 哪个 Action 


当前 页 面 所 在 [sre 指定 该 标签 调用 的 Action 所 在 的 
SR 的 名 称 空间 namespace 


指定 是 否 要 将 Action 的 处 理 结果 页 面包 
含 到 本 页 面 。 默 认 值 为 false， 即 不 包含 


当 Action 被 调用 的 时 候 ， 请 求 参 数 是 否 

ignoreContextParams 应 该 传 入 Action 

ee 在 action 标签 结束 时 ， 输 出 结果 是 否 应 
该 被 刷新 


下 面 的 实例 应 用 到 了 一 个 Action 类 ， 在 Action 中 声明 两 个 属性 分 别 为 festName 和 desc。 
还 有 两 个 方法 execute0 和 welcome()。 代 码 如 下 所 示 。 


public class ActionTag extends Actionsupport { 
private string festName; // 节 日 名 称 
private String desc; // 节 日 描述 
public String getFestName() { 
return festName; 


executeResult i false Boolean 


} 

public String getDesc() { 
return desc; 

} 

public void setDesc (String desc) { 
this.desc = desc; 

} 

public void setFestName (String festName) { 
this.festName = festName; 


} 
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public String execute () throws Exception{ 
return "success"s 
} 
public String welcome(){ 
ServletActionContext.getRequest () .setAttribute ("welcome", "重阳 节 陪 老 
人 登高 ") ; 


return "success"s; 
} 
: 
创建 一 个 成 功 页 面 success.jsp， 当 请 求 方法 execute0) 成 功 之 后 ， 将 跳 转 到 该 页 面 ， 代 码 如 
下 所 示 。 
节日 名 称 : <s:property value="festName"/><br/> 
节日 描述 : <s:property value="desc"/><br/> 


创建 一 个 welcome_success.jsp 页 面 , 使 用 <s:action> 标 签 来 调用 ActionTag 的 两 个 逻辑 方法 
execute() 和 welcome()。 代 码 如 下 所 示 。 

<h3> 执 行 结果 ， 并 将 结果 页 面 的 输出 包含 到 本 页 面 中 </h3> 

<s:action name="first" executeResult="true"/> 

<h3> 不 执行 结果 ， 调 用 ActionTag 的 welcome () 方 法 ， 获 取 请 求 对 象 中 的 welcome 属性 </h3> 

<s:action name="welcome" executeResult="false"/> 

<s:property value="#attr.welcome"/> 

<h3> 执 行 结果 ， 并 通过 嵌 套 的 param 标签 ， 设 置 ActionTag 的 festName 和 desc 属性 </h3> 

<s:action name="first" executeResult="true"> 

<s:param name="festName"” value="' 元 宵 节 '"></s:param> 
<s:param name="desc" value="' 吃 元 宵 的 节日 哦 '"></s:param> 

</s:action> 

上 述 代 码 使 用 action 标签 配置 了 名 为 first 的 Action, 并 指定 了 executeResult 属性 来 控制 是 
和 否 将 处 理 结果 包含 到 本 页 面 中 ,请求 Action 成 功 之 后 将 跳 转 到 success.jsp 页 面 , 但 由 于 没有 为 
Action 的 festName 和 desc 属性 赋值 ， 所 以 显示 为 null。 使 用 param 标签 为 Action 传 入 参数 之 
后 ， 将 输出 显示 属性 值 。 使 用 action 标签 还 配置 了 名 为 welcome 的 Action， 并 使 用 property 标 
签 输出 显示 了 welcome 参数 值 。 

7. include 标 签 

include 标签 用 于 将 一 个 JSP 页 面 ， 或 者 一 个 Servlet 包含 到 本 页 面 中 。 它 类 似 于 JSP 中 的 
<jsp:include> 标 签 。 在 include 标签 体内 也 可 以 包含 多 个 param 标签 ， 向 被 包含 的 页 面 传递 请 求 

include 标签 的 属性 如 表 8-11 所 示 。 


表 8-11 include 标 签 的 属性 


说 
指定 该 标签 的 ID 引用 
指定 需要 被 包含 的 JSP 页 面 或 者 Servlet 


明 


qeM 


< 
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使 用 include 标签 来 包含 festl.jsp 和 fest2.jsp 页 面 ， 代 码 如 下 所 示 。 


<h3> 使 用 include 标签 包含 fest1.jsp</h3> 
<s:include value="fest1.jsp"/> 


<h3> 使 用 include 标签 包含 fest2 .jsp， 使 用 param 标签 向 fest2 .jsp 传递 参数 </h3> 


<s:include value="fest2.jsp"> 
<s:param name="name" value="' 七 夕 节 ' /> 


<s:param name="desc” value="' 牛 郎 织 女 的 故事 就 是 从 这 里 开始 的 '"/> 


</s:include> 


上 述 代码 include 标签 包含 了 festl.jsp 页 面 ， 该 页 面 将 显示 “ 祝 大 家 七 夕 节 快 乐 ! ! ! ”， 
使 用 include 标签 包含 fest2.jsp 页 面 时 , 还 需要 使 用 param 标签 引入 name 和 desc 参数 ,在 fest2.jsp 
页 面 中 ， 将 使 用 EL 表达 式 获 取 并 显示 这 两 个 参数 。 代 码 如 下 所 示 。 


祝 大 家 $ {param.name} 快 乐 ! ! ! ${param.desc } 


8. url 标 签 


ul 标签 用 于 生成 一 个 URL 地 址 , 可 以 通过 为 url 标签 指定 param 子 元 素 , 从 而 向 指定 URL 
发 送 请 求 参数 。 如 果 param 标签 的 value 属性 的 值 是 一 个 数组 或 者 Iterator， 那 么 所 有 的 值 都 会 


被 附加 给 URL。 


ul 标签 可 以 指定 的 属性 如 表 8-12 所 示 。 
表 8-12 url 标 签 的 属性 


属性 名 称 是 否 必需 说 阴 
Id 否 指定 该 url 元 素 的 引用 ID 
指定 是 否 包 含 请 求 参数 , 该 属性 的 属性 值 
和 本 只 能 为 none、get 或 者 all 
scheme 否 指定 URL 使 用 的 协议 (HTTP 或 HTTPS) 
指定 用 于 生成 URL 的 action， 如 果 没 有 
action 否 使 用 该 属性 ， 则 使 用 value 属性 给 出 的 值 
生成 URL 
指定 用 于 生成 URL 的 地 址 值 ， 如 果 没 有 
value 否 使 用 该 属性 ， 则 使 用 Action 属性 给 出 的 
值 生成 URL 
anchor 否 指定 URL 的 锚 点 
指定 是 否 编码 生成 的 URL， 默 认 值 为 
encode 否 true, 便于 在 客户 端 浏 览 器 不 支持 Cookie 
时 , 采用 URL 重 写 的 机 制 来 跟踪 Session 
escapeamp 否 指定 是 否 将 “&” 号 转 义 为 “&amp” 
. 2 指定 是 否 将 当前 应 用 程序 的 上 下 文 路 径 
ne (context path) 包 含 在 生成 的 URL 中 
method 否 指定 使 用 的 action 的 方法 
namespace 否 指定 action 所 属 的 名 称 空间 
| 指定 是 否 强制 添加 scheme、 主 机 和 端口 
eHostAndPort 
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下 面 通过 url 标签 来 配置 Action 请 求 ， 并 向 Action 中 传递 参数 ， 代 码 如 下 所 示 。 
只 指定 value 属性 的 形式 。<br> 


<s:url value="welcome.action"/> 
指定 action 属性 ， 且 使 用 param 标签 传 入 参数 .<br/> 
<s:url action="first"> 
<s:param name="festName" value="' 元 旦 '"/> 
<s:param name="desc" value="'1 月 1 日 元 旦 节 '"/> 
</s:url> 
<hr> 
既 不 指定 action 属性 ， 也 不 指定 value 属性 ， 且 使 用 param 传 入 参数 的 形式 。<br/> 
<s:url includeParams = "get"> 
<s:param name="id" value="%{'5468'}"/> 
</s:url> 
<hr> 
同时 指定 action 属性 和 value 属性 ， 且 使 用 param 传 入 参数 的 形式 。<br/> 
<s:url action="first" value="xxx"> 
<s:param name="festName" value="' 元 旦 '"/> 
<s:param name="desc" value="'1 月 1 日 元 旦 节 '"/> 
</s:url> 


9. i18n 和 text 标 签 
il8n 和 text 标签 用 于 为 国际 化 提供 支持 。il8n 标签 用 于 将 一 个 资源 包 放 入 值 栈 ，text 标签 


用 于 从 资源 包 中 获取 消息 。 代 码 如 下 所 示 。 


<s:il8n name="ApplicationResources"> 
<s:text name="title"/> 
</s:il8n> 


il8n 标签 将 基 名 为 ApplicationResources 的 资源 包 放 入 值 栈 中 , text 标签 从 资源 包 中 获取 键 


为 title 的 文本 消息 。 


il8n 标签 和 text 标签 的 属性 表 8-13 和 表 8-14 所 示 。 
表 8-13 i18n 标 签 的 属性 


属性 名 称 | 是 否 必需 | 默认 值 类 型 说 明 


name 是 无 Strin 指定 要 使 用 的 资源 包 的 基 名 


表 8-14 text 标 签 的 属性 


说 明 


如 果 指定 了 该 属性 , 那么 文本 内 容 将 不 会 输出 ， 
而 是 被 保存 到 OgnlContext 中 , 在 text 标签 结束 
后 ， 可 以 通过 该 属性 的 值 来 引用 


指定 要 使 用 的 资源 包 的 基 名 


< 
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10. date 标 签 


date 标签 用 于 格式 化 输出 一 个 日 期 。 除 了 可 以 直接 格式 化 输出 一 个 日 期 外 ，date 标签 还 可 
以 计算 指定 日 期 和 当前 时 刻 之 间 的 时 差 。 
date 标签 的 属性 如 表 8-15 所 示 。 
表 8-15 date 标 签 的 属性 


说 明 
id 指定 引用 该 元 素 的 id 值 
format | 否 Boolean 指定 日 期 的 格式 化 样式 
要 格式 化 的 日 期 值 ， 必 须 指 定 为 java.util.Date 
name 是 String 


的 实例 
指定 是 否 输出 当前 日 期 值 与 给 定 的 日 期 值 之 间 
的 时 差 ， 如 果 为 tue， 则 输出 时 差 


通常 ，nice 属性 和 format 属性 不 同时 指定 (不 指定 nice 属性 时 ， 该 属性 值 为 rue， 表 明 输 
出 指定 日 期 和 当前 时 刻 的 时 差 )， 指 定 format 属性 用 于 将 指定 日 期 按 format 指定 的 格式 来 格式 
化 输出 。 

如 果 没 有 使 用 nice 属性 ， 也 没有 指定 format 属性 ， 那 么 date 标签 将 在 国际 化 资源 包 中 查 
找 struts.date.format 键 ， 使 用 这 个 键 的 值 作为 日 期 的 格式 化 样式 ， 如 果 这 个 键 不 存在 ， 默 认 将 
会 使 用 DateFormat.MEDIUM 格式 化 样式 。 

11. debug 标 签 

debug 标签 用 于 辅助 调试 ， 它 可 以 在 页 面 中 生成 一 个 Debug 超 链接 ， 单 击 这 个 超 链接 ， 可 
以 查看 到 ValueStack 和 ActionContext 中 所 有 的 对 象 。 

debug 标签 只 有 一 个 id 属性 ， 这 个 属性 并 没有 太 大 的 意义 ， 仅 仅 是 该 元 素 的 一 个 引用 ID。 

在 前 面 讲 过 的 set 标签 的 setjsp 页 面 中 添加 一 个 <s:debug> 标 签 ， 可 以 看 到 ValueStack 和 
ActionContext 中 的 内 容 ， 如 图 8-4 所 示 。 


ER 
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8.2.2 ”实例 描述 


在 这 个 信息 化 时 代 , 信息 就 是 金钱 。 如 何 获取 更 多 的 信息 , 总 结 信息 和 运用 信息 创造 财富 ， 
被 人 们 时 刻 关 注 着 。 程 序 也 一 样 ， 获 取 数 据 、 处 理 数 据 和 输出 结果 数据 给 用 户 ， 是 程序 的 执行 
主线 。Stmts 2 提供 的 数据 标签 能 够 使 人 们 更 方便 快捷 地 获取 数据 ， 处 理 数据 和 输出 数据 。 本 
节 实 例 为 读者 展示 的 是 ， 如 何 运 用 数据 标签 来 操作 显示 学 员 的 信息 。 


8.2.3 ”实例 应 用 


【 例 8-2】 显示 学 员 信 息 。 
(1) 在 项 目 src/com/struts2/domain 目录 下 ,新 建 一 个 Student 实体 类 ,声明 name( 学 院 名 称 )、 
sex( 性 别 ) 和 favorite( 爱 好 ) 属 性 ， 并 分 别 给 出 这 三 个 属性 的 get 和 set 方法 ， 代 码 如 下 所 示 。 
public class Student { 
private string name; // 学 员 名 称 


private String sex; // 学 员 性 别 
private String favorite; // 爱 好 


// 下 面 是 上 述 name、sex 和 favorite 属性 的 get 和 set 方法 ， 在 此 省 略 了 
} 


(2) 新 建 一 个 DataAction， 继 承 自 ActionSupport 类 ， 重 写 execute0 方 法 ， 代 码 如 下 所 示 。 


public class DataAction extends ActionSupport{ 


public String execute(){ 
// 向 Request 对 象 中 放 入 info 参数 。 


ServletActionContext.getRequest () .setAttribute ("info"，"1001 班 成 绩 最 
优异 的 学 员 的 信息 ") ; 


return "success"; 


1 


(3) 打开 项 目 src 目录 下 的 struts.xml 文件 ， 向 该 文件 中 添加 DataAction 配置 ， 代 码 如 下 
所 示 。 


<package name="datatag" extends="struts-default"> 
<action name="data" class="com.struts2.action.DataAction"> 
<result>/data.jsp</result> 
</action> 
</package> 


(4) 新 建 一 个 JSP 页 面 datajsp, 在 该 页 面 中 使 用 <s:bean> 标 签 来 实例 化 一 个 Student 对 象 ， 
并 使 用 <s:action> 标 签 访问 DataAction， 并 获取 Action 中 的 参数 和 Student 对 象 的 属性 值 显 示 在 
页 面 中 ， 代 码 如 下 所 示 。 


< 
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<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@ taglib uri="/struts-tags" prefix="s" %> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>My JSP 'data.jsp' starting page</title> 
</head> 
<body> 
<s:bean name="com.struts2.domain.Sstudent" id="student"> 
<s:param name="name” value="' 刘 晓 晓 '"/> 
<s:param name="sex" value="' 女 '" /> 
<s:param name="favorite"” value="' 了 唱歌 '"/> 
</s:bean> 
<s:action name="data" executeResult="false"/> 
<s:property value="#attr.info"/><br/> 
学 员 名 字 : <s:property value="#student .name"/><br/> 
学 员 年 龄 : <s :property value="#student.sex"/><br/> 
学 员 爱 好 : <s :property value="#student.favorite"/><br/> 
</body> 
</html> 


代码 编写 完成 后 ,打开 正 浏览 器 ,在 地 址 栏 中 输入 “http://localhost:8080/Struts2_8/data.jsp”， 
在 页 面 中 可 以 看 到 成 绩 最 优异 学 员 的 信息 ， 执 行 效果 如 图 8-5 所 示 。 


8-5 ”成 绩 最 优异 学 员 的 信息 


8.2.5 ”实例 分 析 


让 


在 本 实例 中 ， 首 先 封装 了 一 个 Student 实体 类 ， 上 声明 name、sex 和 favorite 属性 。 然 后 新 建 
了 一 个 DataAction， 并 在 struts.xml 文件 中 添加 了 这 个 Action 的 配置 。 最 后 新 建 了 一 个 data.jsp 
页 面 , 在 该 页 面 中 使 用 <s:bean> 标 签 来 实例 化 一 个 Student 实例 , 并 为 该 标签 指定 了 id="student' 
属性 ,这 样 我 们 可 以 在 <s:bean> 标 签 之 外 访问 Student 实 例 的 各 个 属性 值 . 此 外 ,还 使 用 <s:action> 
标签 来 访问 了 DataAction, 获取 了 该 Action 的 Request 对象 中 的 info 参数 , 将 它 显示 在 页 面 上 。 
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8.3 ”主题 和 模板 


主题 与 模板 是 Struts 2 所 有 UI 标签 的 核心 ， 在 学 习 Stmuts 2 的 UI 标签 之 前 先 来 学 习 一 下 
主题 与 模板 。 模 板 是 一 个 UI 标签 的 外 在 表现 形式 。 如 果 为 所 有 的 UI 标签 都 提供 了 对 应 的 模板 ， 


那么 这 一 系列 的 模板 将 形成 一 个 主题 。 


9 
宣 .* 视频 教学 ， 光盘 /videos/08/form property.avi GO 长 度 : 13 分钟 


8.3.1 ”基础 知识 一 一 主题 和 模板 


所 有 的 UI 标签 都 是 基于 模板 和 主题 的 。 一 个 模板 就 是 使 用 JSP、Velocity 或 者 FreeMarker 
编写 的 一 个 文件 ， 它 用 于 生成 HIML 页 面 。 将 一 些 具 有 共同 观感 的 模板 组 织 在 一 起 就 形成 了 
主题 。Struts 2 采用 目录 名 作为 主题 名 ， 将 具有 共同 观感 的 模板 文件 放置 在 同一 个 目录 下 ， 主 
题 和 模板 的 目录 结构 如 图 8-6 所 示 。 


加 一 
因 一 


8-6 ”主题 与 模板 的 目录 结构 图 


Struts 2 支持 三 种 模板 引擎 ， 如 下 所 示 。 

@ ”人 (默认 ): 基于 FreeMarker 的 模板 引擎 。 

@ vm: 基于 Velocity 的 模板 引擎 。 

@ jsp: 基于 JSP 的 模板 引擎 。 

可 以 通过 struts properties 文件 中 的 struts.ui.templateSuffix 属性 ， 来 配置 Stmuts 2 使 用 的 默 
认 模 板 引擎 。 

1. 模板 的 加 载 


加 载 模板 主要 基于 模板 路 径 和 主题 名 。 模 板 路 径 通过 struts.properties 文件 中 的 struts.ui. 
templateDir 属性 来 配置 ， 该 属性 的 默认 值 是 template。 加 载 模板 时 ， 首 先 搜索 Web 应 用 程序 根 
路 径 下 的 template 目录 。 然 后 搜索 CLASSPATH 下 的 template 目录 ， 如 果 一 个 标签 使 用 xhtml 
主题 ， 下 面 两 个 位 置 将 被 搜索 ( 按 顺 序 )。 


< 
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@ Web 应 用 程序 根 路 径 下 /template/ajax/template.ftl。 
®© CLASSPATH /template/ajax/template.ftl。 
Strts 2 提供 了 多 种 方法 来 配置 模板 路 径 ， 如 下 所 示 。 
(1) 使 用 UI 标签 的 templateDir 属性 来 配置 模板 路 径 。 
(2) 使 用 page 范围 的 名 为 templateDir 的 属性 来 配置 模板 路 径 。 
(3) 使 用 request 范围 的 名 为 templateDir 的 属性 来 配置 模板 路 径 。 
(4) 使 用 session 范围 的 名 为 templateDir 的 属性 来 配置 模板 路 径 。 
(5) 使 用 application 范围 的 名 为 templateDir 的 属性 来 配置 模板 路 径 。 
(6) 使 用 struts.properties 文件 中 的 strutsuitemplateDir 属性 来 配置 模板 路 径 (默认 值 为 
template)。 
上 述 几 种 配置 模板 路 径 的 方法 , 它们 之 间 存 在 优先 级 关系 , 排列 越 靠 前 的 方法 优先 级 越 高 ， 
采用 优先 级 高 的 方法 配置 的 模板 路 径 ， 将 覆盖 采用 优先 级 低 的 方法 配置 的 模板 路 径 。 
2. 选择 主题 
主题 可 以 按 下 列 的 规则 进行 选择 。 
(1) 使 用 UI 标签 的 theme 属性 来 选择 主题 。 
(2) 使 用 UI 标签 外 围 的 form 标签 的 theme 属性 来 选择 主题 。 
(3) 使 用 page 范围 的 名 为 theme 的 属性 来 选择 主题 。 
(4) 使 用 request 范围 的 名 为 theme 的 属性 来 选择 主题 。 
(5) 使 用 session 范围 的 名 为 theme 的 属性 来 选择 主题 。 
(6) 使 用 application 范围 的 名 为 theme 的 属性 来 选择 主题 。 
(7) 使 用 struts.properties 文件 中 的 struts.ui.theme 属性 来 选择 主题 (默认 值 是 xhtml)。 
mm ， 修改 form 标签 的 theme 属性 ， 可 以 覆盖 整个 表单 的 主题 。 为 用 户 提供 个 性 化 的 界 
技巧 面 观感 时 ， 可 以 使 用 用 户 的 session 来 改变 主题 。 修 改 struts.properties 文件 中 的 
struts.ui.theme 属性 ， 可 以 改变 整个 应 用 程序 的 主题 。 


3. 创建 新 的 主题 

有 时 候 ， 系 统 提供 的 主题 可 能 不 能 完全 满足 程序 开发 者 的 需求 。 此 时 需要 创建 自 定义 的 主 
题 。 如 果 只 是 想 改变 某 个 UI 标签 的 呈现 方式 ， 只 需要 覆盖 现 有 标签 对 应 的 模板 即 可 ， 也 可 以 
创建 新 的 模板 添加 到 现 有 的 主题 .如果 需要 一 套 更 加 丰富 可 重用 的 模板 , 可 以 创建 全 新 的 主题 。 

Struts 2 提供 了 三 种 方式 用 于 创建 新 的 主题 ， 如 下 所 示 。 

(1) 重新 创建 一 个 全 新 的 主题 。 

(2) 包装 一 个 现 有 的 主题 。 

(3) 扩展 一 个 现 有 的 主题 。 

- 般 不 建议 重新 创建 一 个 全 新 的 主题 ， 建 议 采 用 后 两 种 方式 。Struts 2 内 置 提供 的 最 简单 

的 主题 是 simple 主题 ， 它 给 出 了 UI 标签 最 基本 的 结构 ， 可 以 在 它 的 基础 上 包装 或 扩展 一 个 现 
有 的 主题 。 

Stmuts 2 提供 的 xhtml 主题 就 是 一 个 利用 simple 主题 “包装 ”而 成 的 新 主题 。simple 主题 提 
供 了 基本 的 控制 ，xhtml 主题 通过 添加 头 部 和 尾部 “装饰 ”了 更 多 的 控制 。 下 面 是 xhtml 主题 
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下 的 模板 使 用 的 一 种 包装 形式 。 


<#include "/${parameters.templateDir}/xhtml/controlheader.ftl" /> 

<#include "/${parameters.templateDir}/simple/xxx.ftl" /> 

<#include "/${parameters.templateDir}/xhtml/controlfooter.ftl" /> 

上 述 模 板 使 用 xhtml 主题 下 的 controlheader. 包 和 controlfooter.f 模板 包装 了 simple 主题 下 
的 xxx.ft 模板 。 

采用 包装 的 方式 创建 新 主题 ， 需 要 实现 UI 标签 对 应 的 每 一 个 模板 ， 工 作 量 也 是 相当 庞大 
的 。 如 何 才能 更 加 方便 快捷 地 创建 一 个 新 主题 呢 ? Stmts 2 的 主题 提供 了 类 似 对 象 继 承 的 能 力 ， 
即 一 个 主题 可 以 扩展 另 一 个 主题 ， 然 后 重 写 需 要 修改 的 模板 ， 其 余 的 模板 将 从 父 模版 中 加 载 即 
可 。xhtml 主题 不 仅 采 用 了 包装 技术 , 也 采用 了 扩展 技术 。Struts 2 内 置 的 ajax 主题 扩展 了 xhtml 
主题 。 
要 扩展 一 个 主题 , 需要 在 主题 对 应 的 目录 下 包含 一 个 theme.properties 属性 文件 。 在 该 文件 
中 使 用 parent 键 指定 要 扩展 的 主题 名 , 例如 : ajax 主题 包含 的 theme.properties 文件 的 内 容 如 下 。 


parent=xhtml 


8.3.2 ”基础 知识 一 一 Struts 2 内 置 的 四 种 主题 


Struts 2 内 置 的 四 种 主题 ，simple、xhtml、css_xhtml 和 ajax 主题 。 本 节 分 别 向 读者 讲解 这 
四 种 主题 的 特性 。 
simple 主题 是 最 底层 的 结构 , 提供 了 简单 的 HTML 元 素 支 持 , 可 以 用 于 构建 附加 的 功能 或 
行为 。 
xhtml 主题 是 Struts 2 默认 的 主题 ， 它 对 simple 主题 进行 了 包装 和 扩展 ， 提 供 了 附加 的 功 
能 或 行为 。xhtml 主题 还 增加 了 如 下 的 特性 。 
(1) 针对 HIML 标签 (如 textfield 和 select 标签 ) 使 用 标准 的 两 列表 格 布局 。 
(2) 每 个 HTML 标签 的 Label， 即 可 以 出 现在 HTML 元 素 的 左边 , 也 可 以 出 现在 上 边 , 这 
取决 于 labelposition 属性 的 设置 。 
(3) 自动 输出 校 验 错误 信息 。 
(4) 输出 JavaScript 的 客户 端 校 验 。 
》 xhtml 主题 输出 的 表格 ， 有 两 种 布局 方式 : 两 列 布局 方式 (label 和 表单 元 素 分 占 两 
注意 列 ) 和 两 行 布局 方式 (label 和 表单 元 素 分 占 两 行 )， 取决 于 表单 标签 的 labelposition 
属性 的 取 值 (left 或 者 top)。 


css_xhtml 主题 与 xhtml 主题 相似 , 它 也 包装 了 simple 主题 ,扩展 了 xhtml 主题 ;但 css_xhtml 
主题 不 是 采用 表格 对 表单 元 素 进行 布局 ， 而 是 采用 css 和 <div> 对 表单 元 素 进行 布局 的 。 

css_xhtml 主题 增加 了 如 下 特性 。 

(1) 针对 HIML 中 与 表单 相关 的 标签 使 用 标准 的 两 列 基于 CSS 和 <div> 的 布局 。 

(2) 对 于 每 个 HTML 标签 的 label， 依 照 CSS 样式 表 的 设置 来 决定 位 置 。 

(3) 自动 输出 验证 错误 。 

(4) 输出 JavaScript 的 客户 端 校 验 。 


< 
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ajax 主题 也 对 xhtml 主题 进行 了 扩展 ， 并 增加 了 自己 特有 的 特性 。ajax 主题 的 Ajax 支持 是 
以 Dojo 和 DWR 为 基础 的 。ajax 主题 在 xhtml 主题 基础 上 增加 了 如 下 特性 。 


(D) 
CO) 
(3) 
(4 
(5) 
(6) 
(7) 


Ajax 方式 的 客户 端 验证 。 

支持 远程 表单 的 异步 提交 (最 好 和 submit 标签 一 起 使 用 )。 
提供 高 级 的 div 标签 ， 允 许 动态 重新 加 载 部 分 HTML 的 功能 。 
提供 高 级 的 a 标签， 允许 动态 加 载 并 执行 远 端的 JavaScript 代码 。 
支持 Ajax 的 tabbedPanel 实现 。 

提供 “ 富 客 户 端 ”模型 的 pub-sub 事件 模型 。 

交互 的 autocomplete 标签 。 


8.4 个 人 信息 表单 


Struts 2 的 表单 标签 可 以 分 为 两 种 : fomm 标签 本 身 和 单个 表单 元 素 的 标签 。form 标签 本 身 
的 行为 不 同 于 自身 内 部 的 元 素 标签 。Struts 2 的 表单 元 素 标签 包含 了 非常 多 的 属性 ， 但 有 很 多 
属性 完全 是 公共 的 属性 。 本 节 将 在 基础 知识 中 ， 首 先 讲解 表单 标签 的 公共 通用 属性 ， 然 后 再 分 
别 讲解 各 个 元 素 标签 各 自 特 有 的 属性 。 


13 分 钟 
6 分 钟 
6 分 钟 
7 分钟 
6 分 钟 
8 分 钟 
8 分 钟 
9 分 钟 
9 分 钟 
7 分 钟 
10 分 钟 


ca 视频 教学 : 光盘 /videos/08/form property.avi 加 长 度 : 
光盘 /videos/08/form.avi 加 攻 度 : 
光盘 /videos/08/select.avi 加 天 度 : 
光盘 /videos/08/optgroup.avi 加 攻 度 : 
光盘 /videos/08/radio.avi 加 攻 度 : 
光盘 /videos/08/combobox.avi 加 攻 度 : 
光盘 /videos/08/checkboxlist.avi 加 攻 度 : 
光盘 /videos/08/doubleselct.avi 加 基 度 : 
光盘 /videos/08/optiontransferselect.avi [i 
光盘 /videos/08/updownselect.avi 全 攻 度 : 
光盘 /videos/08/submit.avi 全 攻 度 : 
8.4.1 ”基础 知识 一 一 表单 标签 
Stmts 2 的 所 有 表单 标签 处 理 类 都 继承 自 UIBean 类 ，UIBean 包含 了 一 些 通用 属性 ， 这 些 
通用 属性 分 为 四 种 。 
@ ”模板 相关 的 属性 。 
@ JavaScript 相关 的 属性 。 
@ 工具 提示 相关 的 属性 。 
@ 通用 属性 。 


除了 这 些 属性 外 ， 所 有 表单 元 素 标签 都 存在 一 个 特殊 的 属性 : form($ {parameters.form})， 
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全 


这 个 属性 引用 表单 元 素 所 在 的 表单 ， 通 过 form 属性 可 以 实现 表单 元 素 与 表单 之 间 的 交互 。 例 
如 : 使 用 ${parameters.form.id} 获 取 form 标签 的 id 属性 。 

(1) 模板 相关 的 属性 。 

模板 相关 的 通用 属性 如 表 8-16 所 示 。 


表 8-16 ”模板 相关 的 通用 属性 


属性 名 称 


templateDir 


数据 类 型 说 明 
指定 表单 所 用 的 模板 文件 目录 
指定 表单 所 用 的 主题 


指定 表单 所 用 的 模板 


String 
String 
(2) JavaScript 相关 的 属性 。 
JavaScript 相关 的 通用 属性 如 表 8-17 所 示 。 
表 8-17” JavaScript 相关 的 通用 属性 
属性 名 称 主题 说 明 


指定 鼠标 在 该 标签 生成 的 表单 元 素 上 单 击 时 触发 的 
JavaScript 函数 


: se 指定 鼠标 在 标签 生成 的 表单 元 素 上 双击 时 触发 的 
ondbclick simple 2 
JavaScript 函数 


theme 


template 


onclick simple 


指定 鼠标 在 该 标签 生成 的 表单 元 素 上 松 开 时 触发 的 


onmouseup simple String JavaScript 函数 
avaScripl 
指定 鼠标 在 该 标签 生成 的 表单 元 素 上 按 下 时 触发 的 
onmousedown simple i 
JavaScript 函数 
| _ 指定 鼠标 移出 该 标签 生成 的 表单 元 素 时 触发 的 
onmouseout simple String . 
JavaScript 函数 
指定 鼠标 在 该 标签 生成 的 表单 元 素 上 其 停 时 触发 的 
‘onmouseover simple String R 
JavaScript 函数 
onfocus simple String 指定 该 标签 生成 的 表单 元 素 得 到 焦点 时 触发 的 函数 
onblur simple String 指定 该 标签 生成 的 表单 元 素 失 去 焦点 时 触发 的 函数 
onkeypress simple String 指定 单 击 键盘 上 某 个 键 时 触发 的 函数 
onkeyup simple String 指定 松 开 键盘 上 某 个 键 时 触发 的 函数 
onkeydown simple String 指定 按 下 键盘 上 某 个 键 时 触发 的 函数 
对 下 拉 列 表 项 等 可 以 选择 表单 元 素 ， 指 定 选中 该 元 素 
onselect Simple String 时 触发 的 JavaScript 函数 
ee ee 对 于 文本 框 等 可 以 接受 输入 的 表单 元 素 ， 指 定 当 值 改 
Be Se pe 变 时 触发 的 Javascript 函数 


怀 总 mm 
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由 于 HTML 元 素 本 身 的 限制 ,并 不 是 每 个 HTML 元 素 都 可 以 触发 以 上 的 所 有 函数 ， 
注意 因此 ， 上 面 的 属性 并 不 是 对 Struts 2 的 每 个 标签 都 有 效 。 
(3) 工具 提示 相关 的 属性 。 
Struts 2 为 表单 元 素 提供 了 提示 功能 ， 当 鼠标 在 表单 元 素 上 悬 停 时 ， 浏 览 器 显示 浮动 的 提 
示人 信息。 工具 提示 相关 的 通用 属性 如 表 8-18 所 示 。 


表 8-18 工具 提示 相关 的 通用 属性 


说 明 
设置 此 组 件 的 Tooltip 
配置 工具 提示 的 各 种 属性 


tooltip 


tooltipConfig 


(4) 通用 属性 。 
通用 属性 如 表 8-19 所 示 。 
表 8-19 通用 属性 
属性 名 称 主 题 数据 类 型 说 阴 
cssClass simple String 设置 表单 元 素 的 class 属性 
cssStyle simple String 设置 表单 元 素 的 style 属性 ， 使 用 内 联 的 CSS 样式 
title simple String 设置 表单 元 素 的 title 属性 
disabled simple String 设置 表单 元 素 的 disabled 属性 
label xhtml String 设置 表单 元 素 的 label 属性 
a 本 Se 设置 表单 元 素 label 所 在 位 置 ， 可 接受 的 值 为 top( 上 面 ) 和 
left( 左 边 )， 默 认 是 在 左边 
A : 定义 必 填 标记 (默认 以 * 作 为 必 填 标记 ) 位 于 label 元 素 的 位 
requiredposition | xhtml String 置 ， 可 接受 的 值 为 left( 左 面 ) 和 right( 右 边 )， 默认 是 在 右边 
定义 表单 元 素 的 name 属性 ， 该 属性 值 用 于 与 Action 的 属 
name simple String 性 形成 对 应 
定义 是 否 在 表单 元 素 的 label 上 增加 必 填 标记 (默认 以 * 作 
di ce | 为 必 填 标记 )， 设 置 为 mue 时 增加 必 填 标记 ， 否 则 不 增加 
tabindex simple String 设置 表单 元 素 的 tabindex 属性 
Value Simple String 设置 表单 元 素 的 value 属性 
ee i Se 指定 表单 元 素 对 应 的 action 的 属性 名 。 该 属性 将 自动 生成 


name，label 和 value 属性 的 值 


虽然 UI 标签 都 支持 上 述 属 性 ,但 对 于 某 些 标签 来 说 ， 上 述 的 某 些 属性 是 没有 意义 
注意 的 或 者 是 不 需要 的 ， 例 如 form 标签 支持 tabindex 属性 ,但 是 没有 任何 一 个 主题 呈 
现 这 个 属性 。 
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1. form 标 签 


form 标签 用 于 输出 一 个 HTML 输入 表单 ， 此 外 ，xhtml 主题 的 form 标签 还 输出 表单 元 素 
外 围 的 表格 。 
除了 公共 属性 外 ，form 标签 的 常用 属性 如 表 8-20 所 示 。 


表 8-20 form 标 签 的 常用 属性 


属性 名 称 说 明 
a 指定 提交 的 Action 的 名 字 ， 不 要 添加 .action 
action 当前 的 Action 
后 缀 
namespace Y 当前 的 名 称 空间 ing 指定 提交 的 Action 所 属 的 名 称 空 间 
HTML 表单 的 method 属性 , 取 值 为 get 或 者 
method ot 
enctype 上 传 文件 时 ， 设 为 multipart/form-data 
nt 指定 某 个 表单 元 素 的 i4， 当 页 面 被 加 载 时 ， 
该 元 素 将 具有 焦点 
e 该 属性 只 有 在 使 用 xhtml 或 ajax 主题 时 才 有 
validate 


效 ， 用 于 指定 是 否 执 行 客户 端 验证 
form 标签 的 用 法 具体 如 下 所 示 。 

<s:form action="login" method="post"/> 

2.textfield 标 签 


textfield 标签 用 于 输出 一 个 HTML 单行 文本 输入 控件 ， 相 当 于 HTML 代码 : <input 
type="text" .../>。 
除了 公共 属性 外 ，textfield 标签 的 属性 如 表 8-21 所 示 。 


表 8-21 textfield 标签 的 属性 
属性 名 称 


说 明 
maxlength 文本 输入 控件 可 以 输入 字符 的 最 大 长 度 
二 人 如 果 该 属性 值 设 为 tue， 用 户 将 不 能 在 文本 控 
件 中 输入 文本 
size j Integer 指定 文本 输入 控件 的 可 视 尺 寸 


使 用 form 标签 和 textfield 标签 实现 一 个 登录 表单 ， 代 码 如 下 所 示 。 


<s:form action="login" method="post"> 
<s:textfield name="username"” label=" 用 户 名 "/> 
<s:textfield name="password"” label=" 密 码 "/> 
</s:form> 


3. password 标 签 


password 标签 用 于 输出 一 个 HTML 口令 输入 控件 ， 相 当 于 HTML 代码 : <input type= 


"password" .../>。 
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除了 公共 属性 外 ，password 标签 的 属性 如 表 8-22 所 示 。 


表 8-22 ”password 标签 的 属性 


属性 名 称 类 型 说 明 
maxlength Integer 口令 输入 控件 可 以 输入 字符 的 最 大 长 度 
当 该 属性 的 值 为 true 时 ， 用 户 不 能 在 口令 
readonly 否 false Boolean 控件 中 输入 密码 


[| 否 Integer 指定 口令 输入 控件 的 可 视 尺 寸 
是 否 显示 密码 。 当 设 为 tue 时 ， 密 码 被 显 
示 。 一 般 不 要 设 为 tme 


Size 


showPassword i? Boolean 


password 标签 的 用 法 如 下 。 
<s:password name="password" label=" 密 码 " /> 


4. textarea 标 签 
textarea 标签 用 于 输出 一 个 HTML 多 行文 本 输入 控件 , 相当 于 HTML 代码 : <textarea .../>。 
除了 公共 属性 外 ，textarea 标签 的 属性 如 表 8-23 所 示 。 
表 8-23 ”textarea 标签 的 属性 
属性 名 称 | 是 否 必需 | 默认 值 说 明 
i 指定 多 行文 本 输入 控件 的 可 输入 文本 的 列 数 
i 指定 多 行文 本 输入 控件 可 输入 文本 的 行 数 


2 当 该 属性 的 值 为 rue 时， 用 户 不 能 在 文本 输入 
readonly 否 false Boolean 控件 中 输入 文本 


wap 指定 多 行文 本 输入 控件 中 的 内 容 是否 应 该 换行 
textarea 标签 的 用 法 如 下 所 示 。 


<s:textarea name="dep desc" cols="50" rows="5" label=" 部 门 简介 "/> 


5. select 标 签 
select 标签 用 于 输出 一 个 HTML 列表 框 ， 相 当 于 HTML 代码 。 


<select .><option .>.</Voption></select> 
除了 公共 属性 外 ，select 标签 的 属性 如 表 8-24 所 示 。 
表 8-24 select 标签 的 属性 


属性 名 称 类 型 说 明 
指定 将 要 迭代 的 集合 ， 使 用 该 集合 中 
Collection 、 Map 、 的 元 素来 设置 各 个 选项 。 如果 list 属性 
list Enumeration、Iterator | 的 值 是 一 个 Map， 则 Map 的 key 会 成 
或 者 Array 为 选项 的 value，Map 的 value 会 成 为 
选项 的 内 容 
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续 表 


属性 名 称 是 否 必 需 说 明 
listKey 否 指定 集合 元 素 中 对 象 的 某 个 属性 作为 
选项 的 value 
否 指定 集合 元 素 中 对 象 的 某 个 属性 作为 
listValue 否 


选项 的 内 容 
指定 当 用 户 选 择 了 header 选项 时 提交 
的 值 ， 如 果 使 用 该 属性 ， 不 能 为 该 属 
性 赋 空 值 


headerKey 否 


headerValue | 否 指定 显示 在 页 面 中 header 选项 的 内 容 
指定 是 否 在 header 选项 后 面 添 加 一 个 

emptyOption | 否 Boolean 空 选项 

multiple 否 Boolean 设置 列表 框 是 否 允 许多 选 


设置 下 拉 列 表 框 可 显示 的 选项 个 数 


Size 


select 标签 的 用 法 如 下 所 示 。 


<s:form> 
<s:select label=" 性 别 " name="education"” 1ist="{' 男 ', ' 女 '}"/> 
</s:form> 


上 述 代 码 通 过 list 属性 直接 使 用 OGNL 表达 式 创建 了 一 个 列表 , 它 产生 的 效果 与 下 面 代码 
产生 的 一 样 。 


<select name="sex" id="sex"> 
<option value=" 男 "> 男 </option> 
<option value=" 女 "> 女 </option> 
</select> 


select 标签 的 list 属性 也 可 以 直接 使 用 OGNL 表达 式 创建 一 个 Map。Map 中 的 key 作为 列 
表 框 选项 的 值 ， Map 中 的 value 是 作为 列表 框 选项 的 内 容 。 代 码 如 下 所 示 。 


<s:form> 
<s:select label=" 性 别 " name="sex"” 1ist="#{1:' 男 ',2:' 女 '}"/> 
</s:form> 


select 标签 在 客户 端 浏览 器 中 的 输出 ， 代 码 如 下 所 示 。 
<select name="sex" id="sex"> 
<option value="1"> 男 </option> 


<option value="2"> 女 </option> 
KLSeLecEtS 


使 用 select 标签 的 headerKey 和 headerValue 属性 可 以 设置 header 选项 ， 代 码 如 下 所 示 。 


<s:form> 
<s:select label=" 性 别 " name="sex” 1ist="{' 男 ', ' 女 '}" 
headerKey="-1"” headerValue=" 请 选择 您 的 性 别 "/> 
</s:form> 


< 
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设置 header 选项 主要 目的 就 是 用 来 提示 用 户 操 作 ， 因 此 将 header 选项 的 值 使 用 headerKey 
属性 设 为 无 意义 的 值 ， 如 -1。 
6. optgroup 标 签 
optgroup 标签 作为 select 标签 的 子 标签 ， 用 于 创建 选项 组 。 可 以 在 select 标签 的 标签 体 中 
使 用 一 个 或 者 多 个 optgroup 标签 ， 对 选项 进行 逻辑 分 组 。 但 optgroup 标签 自身 不 能 嵌 套 。 
除了 公共 属性 外 ，optgroup 标签 的 属性 如 表 8-25 所 示 。 
表 8-25 optgroup 标 签 的 属性 


属性 名 称 类 型 说 明 
指定 将 要 人 迭代 的 集合 ， 使 用 集合 中 的 元 
素来 设置 各 个 选项 如果 list 属性 的 值 是 
一 个 Map， 则 Map 的 key 会 成 为 选项 的 
value，Map 的 value 会 成 为 选项 的 内 容 
指定 集合 元 素 中 对 象 的 某 个 属性 作为 选 
项 的 value 
指定 集合 元 素 中 对 象 的 某 个 属性 作为 选 
项 的 内 容 

使 用 select 标签 创建 一 个 下 拉 列 表 框 , 并 使 optgroup 标签 为 select 标签 中 的 选项 进行 分 组 。 
代码 如 下 所 示 。 

<s:form> 


<s:select label=" 职 位 "name="position" 1ist="#{1:' 经 理 ',2:' 主 管 ', 3:' 代 表 
jn"> 


Collection 、Map 、 
list Enumeration 
Iterator 或 者 Array 


listKey ? String 


listValue 


<s:optgroup label=" 项 目 组 长 ”1ist="#{4:'Java 项 目 组 长 ', 5:'.net 项 目 组 长 
"> 
<s:optgroup label=" 普 通 员工 ”1ist="#{6:'Java 程序 员 ' ,7:' .net 程序 员 '}"/> 
</s:select> 
</s:form> 


7. radio 标 签 
radio 标签 用 于 输出 一 组 HIML 单 选 按 钮 ,相当 于 一 组 HTML 代码 : <input type="radio" .…./> 
除了 公共 属性 外 ，radio 标签 的 属性 如 表 8-26 所 示 。 

表 8-26 radio 标签 的 属性 


属性 名 称 类 型 说 明 
Collection、Map、| 指定 将 要 迭代 的 集合 ， 使 用 集合 中 的 元 素 
证 Enumeration 、 来 设置 各 个 选项 ,如 果 list 属性 的 值 是 一 个 
Iterator 或 者 | Map， 则 Map 的 key 会 成 为 选项 的 value， 
Array Map 的 value 会 成 为 选项 的 内 容 
Tey 指定 集合 元 素 中 对 象 的 某 个 属性 作为 选项 
的 value 
有 指定 集合 元 素 中 对 象 的 某 个 属性 作为 选项 
listValue 


的 内 容 
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radio 标签 的 使 用 方式 与 select 标签 相似 ， 它 的 具体 用 法 如 下 所 示 。 


<s:form> 
<s:radio name="ismarry” value="1"” 1ist="#{1:' 已 婚 ', 0:' 未 婚 ' }"” label=" 是 否 

婚配 "/> 

</s:form> 

上 述 代码 中 将 radio 标签 的 value 属性 的 值 设置 为 1, 该 值 将 与 list 属性 配置 的 Map 中 的 元 
素 进行 比较 ， 值 为 1 的 选项 被 默认 选中 。 

8. checkbox 标 签 

checkbox 标签 用 于 输出 一 个 HTML 复 选 枉 ， 相 当 于 HTML 代码 。 

<input type="checkbox" ../> 

除了 公共 属性 外 ，checkbox 标签 还 有 一 个 fieldValue 属性 ， 该 属性 是 使 用 时 必需 指定 的 ， 
默认 值 为 rue， 指 定 在 复 选 框 选中 时 ， 实 际 提交 的 值 。 

如 果 需 要 使 用 checkbox 标签 创建 一 个 value 属性 为 true 或 者 false 的 复 选 框 。 可 以 通过 
checkbox 标签 的 fieldValue 属性 来 指定 创建 HTML 复 选 框 value 属性 的 值 。 代 码 如 下 所 示 。 


<s:checkbox name="protocol" label=" 是 否 同意 上 述 条 款 " fieldvalue="true"/> 


将 fieldValue 属性 设置 为 false， 可 能 会 导致 一 些 问 题 ， 所 以 一 般 情况 下 不 要 将 
注意 fieldValue 属性 设置 为 false。 
9. checkboxlist 标 签 


checkboxlist 标签 可 以 创建 一 系列 复 选 枉 ， 属 性 设置 与 select 和 radio 标签 相似 。 除 了 公共 
属性 外 ，checkboxlist 标签 的 属性 如 表 8-27 所 示 。 


表 8-27 checkboxlist 标 签 的 属性 


属性 名 称 | 是 否 必需 说 了 明 
ER Nabi 指定 将 要 逻 代 的 集合 ， 集合 中 的 元 素 用 
List 是 Enumeration 、 Iterator 来 设置 各 个 选项 如果 1it 属性 的 信 是 一 
或 者 Amay 个 Map， 则 Map 的 key 会 成 为 选项 的 
value，Map 的 value 会 成 为 选项 的 内 容 
listgey 否 指定 集合 元 素 中 对 象 的 某 个 属性 作为 选 
项 的 value 
多 指定 集合 中 对 象 的 某 个 属性 作为 选项 的 
listValue 否 


内 容 
使 用 checkboxlist 标签 ， 创 建 一 个 系列 复 选 框 ， 用 来 选取 学 习 科目 ， 用 法 如 下 所 示 。 


<s:form> 
<s:checkboxlist name="interest" 1ist="{' 语 文 ', ' 数 学 ', ' 英 语 ',' 物 理 ', ' 化 学 ',' 
地 理 '}"” label=" 学 习 科目 " /> 


</s:form> 


qeM 


< 


PN 


10. combobox 标 签 
combobox 标签 用 于 生成 一 个 单行 文本 框 和 下 拉 列 表 框 的 组 合 。 两 个 表单 元 素 只 对 应 一 个 
请 求 参 数 ， 只 有 单行 文本 框 里 的 值 才 包 含 请 求 参 数 ， 下 拉 列 表 框 只 是 用 于 辅助 输入 ， 并 没有 
name 属性 ， 不 会 产生 请 求 参数 。 可 以 使 用 列表 框 将 文本 放置 到 文本 控件 中 ， 也 可 以 直接 在 文 
本 控件 中 输入 文本 。 
除了 公共 属性 外 ，combobox 标签 的 属性 如 表 8-28 所 示 。 
表 8-28 combobox 标 签 的 属性 


属性 名 称 类 型 说 明 
本 re Se 要 迭代 的 集合 , 使 用 集合 中 的 元 素来 设 
和 
ee 置 列表 框 中 的 各 个 选项 
ee | 本 本 指定 组 合 框 的 文本 控件 部 分 可 以 输入 
axXjengi eger 字符 的 最 大 长 度 
| 当 该 属性 的 值 为 rue 时 ,用 户 不 能 在 文 


'y 指定 组 合 框 的 文本 输入 控件 部 分 的 可 
Size 否 无 Integer 视 尺寸 


使 用 combobox 标签 创建 一 个 选择 娱乐 项 目的 组 合 选择 框 ， 代 码 如 下 所 示 。 
<s:form> 
<s:combobox 
label=" 请 选择 娱乐 项 目 " 
name="play" 
list="{ ! 听 音乐 '， ' 打 棒球 ' 1 跳舞 ' 游 泳 ' }" 
headerKey="-1" 
headerValue="--- 请 选择 ---" 
emptyOption="true"/> 
</s:form> 
用 户 可 以 通过 下 拉 列 表 框 选择 娱乐 项 目 ， 也 可 以 在 文本 控件 中 直接 输入 娱乐 项 目 。 
11. doubleselect 标 签 


doubleselect 标签 输出 关联 的 两 个 HTML 列表 框 ， 第 二 个 列表 框 显示 的 内 容 随 第 一 个 列表 
框 选中 的 选项 而 变化 。 除 了 公共 属性 外 ，doubleselect 标签 的 属性 如 表 8-29 所 示 。 
表 8-29 doubleselect 标 签 


属性 名 称 类 型 说 明 
指定 将 要 迭代 的 集合 ， 集 合 中 的 元 素 用 来 
设置 各 个 选项 。 如 果 list 属性 的 值 是 一 个 
Map， 则 Map 的 key 会 成 为 选项 的 value， 
Map 的 value 会 成 为 选项 的 内 容 


Collection、Map、 
List Enumeration 、 


Iterator 或 者 Array 


mi >> 
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@- 
续 表 
属性 名 称 是 否 必需 说 明 
指定 集合 元 素 中 对 象 的 某 个 属性 作为 选 
listKey 得 
项 的 value 
指定 集合 中 对 象 的 某 个 属性 作为 选项 的 
listValue 否 
内 容 
指定 用 户 在 第 一 个 列表 框 中 选择 header 
headerKey 否 选项 提交 的 值 。 使 用 该 属性 不 能 为 它 赋 
空 值 
headerValue 指定 第 一 个 列表 框 的 header 选项 的 内 容 
i 否 a 是 否 在 第 一 个 列表 框 的 header 选项 后 面 
tt 
emptyOption oolean 派 加 一 个 空 选项 
该 属性 对 两 个 列表 框 都 适用 ， 如 果 设 置 为 
Multiple 否 Boolean 


true， 则 两 个 列表 框 都 为 多 选 列表 框 


加 设置 下 拉 列 表 框 可 显示 的 选项 个 数 , 该 属 
到 性 只 对 第 一 个 列表 框 起 作用 


Collection、Map、| 、 
该 属性 对 list 属性 中 的 每 一 个 元 素 求 值 ， 
doubleList 是 无 Enumeration 


A 
Iterator 或 者 Arral 返回 一 个 迭代 的 集合 


指定 集合 元 素 中 对 象 的 某 个 属性 作为 选 
doubleListKey | 否 无 项 的 value。 该 属性 只 对 第 二 个 列表 框 起 

作用 

指定 集合 元 素 中 对 象 的 某 个 属性 作为 选 
doubleListValue | 否 无 相国 项 的 内 容 。 该 属性 只 对 第 二 个 列表 框 起 作 

用 


设置 下 拉 列 表 框 可 显示 的 选项 个 数 ， 该 属 
性 只 对 第 二 个 列表 框 起 作用 

指定 第 二 个 列表 框 的 name 映射 ， 该 属性 
doubleName 是 无 String 


doubleSize 否 无 Integer 


的 值 与 Action 的 属性 对 应 
doubleValue 否 无 Object 第 二 个 列表 框 的 初始 选中 项 


使 用 doubleselect 标签 ， 创 建 一 个 选择 省 份 与 城市 的 下 拉 列 表 框 ， 代 码 如 下 所 示 。 


<s:doubleselect label=" 请 选择 所 在 省 市 " 
name="province™" 
list="{' 河 南 省 ', ' 浙 江 省 ' }" 
doubleName="city" 
doubleList="top==' 河 南 省 '?{' 郑 州 市 ', ' 巩 义 市 '} :{' 杭 州 市 ', ' 温 州 市 '}"> 


</s:doubleselect> 


必 人 mm 
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12. optiontransferselect 标 签 


optiontransferselect 标签 用 于 创建 一 个 选项 转移 列表 组 件 ， 


该 标签 会 生成 两 个 <select .. 


在 


标签 , 并 且 会 生成 系列 的 按钮 ,这些 系列 的 按钮 可 以 控制 选项 在 两 个 下 拉 列 表 之 间 移 动 、 升 降 。 


当 提 交 表 单 时 ， 将 提交 两 个 列表 框 中 选中 的 选项 。 


除了 公共 属性 外 ，optiontransferselect 标签 的 属性 如 表 8-30 所 示 。 
表 8-30 optiontransferselect 标 签 的 属性 


属性 名 称 。 | 是 否 必需 | 默认 值 | 类 型 | 说 明 
指定 要 迭代 的 集合 ， 使 用 集合 中 的 元 素来 
Collection、 Map、 
设置 各 个 选项 。 如 果 list 属性 的 值 是 一 个 
Enumeration 
List 是 et 或 者 Map， 则 Map 的 key 会 成 为 选项 的 value， 
erator 马 
Map 的 value 会 成 为 选项 的 内 容 。 该 属性 
只 对 第 一 个 列表 框 起 作用 
过 指定 使 用 集合 中 对 象 的 某 个 属性 作为 选项 
Ca 的 value 该 属性 只 对 第 一 个 列表 框 起 作用 
有 了 指定 使 用 集合 中 对 象 的 某 个 属性 作为 选项 
lsStvalue 
的 内 容 。 该 属性 只 对 第 一 个 列表 框 起 作用 
设置 当 用 户 在 第 一 个 列表 框 中 选择 了 
headerKey 否 header 选项 时 提交 的 值 。 如 果 使 用 该 属性 ， 
不 能 为 该 属性 赋 空 什 
headerValue 否 无 sa | 设置 第 一 个 列表 框 的 header 选项 的 内 容 
人 时 设置 是 否 在 第 一 个 列表 框 的 header 选 项 后 
empty' ption alse Oolean 面 添加 一 个 空 的 选项 
本 要 | 设置 是 否 第 一 个 列表 框 为 多 选 列表 框 。 设 
Re er 置 为 true 表示 为 多 选 列表 框 
| Re A 该 属 
3 一 个 列表 框 起 作用 
doubleId -个 列表 框 的 id 
指定 要 迭代 的 集合 ， 使 用 集合 中 的 元 素来 
Collection、Map、| 、 
设置 各 个 选项 。 如 果 doubleList 属性 的 什 
Enumeration 
doubleList 是 是 一 个 Map, 则 Map 的 key 会 成 为 选项 的 
Iterator 或 者 
value，Map 的 value 会 成 为 选项 的 内 容 。 
该 属性 只 对 第 二 个 列表 框 起 作用 
ee 指定 使 用 集合 中 对 象 的 某 个 属性 作为 选项 
ee 的 value。 该 属性 只 对 第 二 个 列表 框 起 作用 
We 指定 使 用 集合 中 对 象 的 某 个 属性 作为 选项 
人 的 内 容 。 该 属性 只 对 第 二 个 列表 框 起 作用 


mm >> 
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续 表 
属性 名 称 是 否 必需 | 默认 值 | 类 型 说 明 
指定 当 用 户 选中 第 二 个 列表 框 中 header 选 
doubleHeaderKey 否 无 String 项 时 提交 的 值 。 如 果 使 用 该 属性 ， 不 能 赋 
为 空 什 
doubleHeaderValue 3 String 指定 第 二 个 列表 框 的 header 选项 的 内 容 
doubleEmptyOption 元 String 人 
加 一 个 空 选项 
doubleMultiple 否 true Boolean de 
为 多 选 列表 框 
re 设置 下 拉 列 表 框 可 显示 的 选项 个 数 ， 该 属 
性 只 对 第 二 个 列表 框 起 作用 
Ee 指定 第 二 个 列表 框 的 name 映射 ， 该 属性 
的 值 与 Action 的 属性 对 应 
doubleValue 否 第 二 个 列表 框 的 初始 选中 项 
leftTitle 否 Ed 设置 左边 列表 框 的 标题 
rightTitle 否 | 无 。 |stine | 设置 右边 列表 框 的 标题 
addToL eftL abel 否 |< [suing 。 ”| 设置 向 左 移动 的 按钮 上 的 文本 
addToRightLabel 。 | 否 [| 设置 向 右 移动 的 按钮 上 的 文本 
addAllToLeftLabel | 否 | sting 。 | 设置 全 部 移动 到 左边 的 按钮 上 的 文本 
addAllToRightLabel “| 否 | 设置 全 部 移动 到 右边 的 按钮 上 的 文本 
selectAllLabel 否 |<*> | suing 。 ”| 设置 全 部 选择 按钮 上 的 文本 
leftUpLabel 否 | |stine | 设置 左边 列表 框 的 向 上 移动 按钮 上 的 文本 
lefDownLabel 否 | ~ swine。 | 设置 左边 列表 框 的 向 下 移动 按钮 上 的 文本 
rightUpLabel 否 sre | 设置 右边 列表 框 的 向 上 移动 按钮 上 的 文本 
iightDownLabel 否 | - [swing 。 ”| 设置 右边 列表 框 的 向 下 移动 按钮 上 的 文本 
allowAddToLeft 否 odie 设置 是 否 使 用 移动 到 左边 的 按钮 
allowAddToRight 。 | 否 Boia 设置 是 否 使 用 移动 到 右边 的 按钮 
allowAddAliToLeft | 否 设置 是 否 使 用 全 部 移动 到 左边 的 按钮 
allowAddAllToRight | 否 设置 是 否 使 用 全 部 移动 到 右边 的 按钮 
allowSelectAll 否 设置 是 否 使 用 全 部 选择 按钮 
四 设置 是 否 使 用 左边 列表 框 的 上 移 和 下 移 
allowUpDownOnLeft | 否 按钮 
区 设置 是 否 使 用 右边 列表 框 的 上 移 和 下 移 
allowUpDownOnRight | 否 按钮 


常常 无 需 指 定 id 和 doubleId 属性 ,因为 这 两 个 属性 将 由 optiontransferselect 标签 自 


注意 动 生 成 。 


该 标签 所 生成 的 id 和 doubleld 分 别 为 <form id>_ 


<optiontransferselect name> 和 <form id> <optiontransferselect_ doubleName>。 


< 
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使 用 optiontransferselect 标签 分 别 指定 两 个 简单 的 集合 , 来 生成 两 个 下 拉 列 表 框 的 列表 项 ， 
可 以 选择 喜欢 的 运动 。 代 码 如 下 所 示 。 


<s:head/> 
<s:form> 
<s:optiontransferselect 
labe1=" 最 喜欢 的 运动 " 
name="tsports"™" 
leftTitle=" 球 类 运动 " 
rightTitle=" 娱 乐 运动 " 
list="{' 打 网 球 ',' 打 棒球 ', ' 踢 足球 ' }" 
headerKey="-1" 
headerValue="--- 请 选择 ---" 
doubleName="jsports" 
doubleList="{' 健 身体 操 ',' 跳 绳 ',' 踢 律 子 ',' 游 泳 '}" 
doubleHeaderKey="-1" 
doubleHeaderValue="--- 请 选择 ---" 
doubleEmptyOption="true" 
addToLeftLabel=" 向 左 移动 " 
addToRightLabel=" 向 右 移动 " 
adqdAllToLeftLabel=" 全 部 左 移 " 
addAllToRightLabel=" 全 部 右 移 " 
selectAllLabel=" 全 部 选择 " 
leftUpLabel=" 向 上 移动 " 
leftDownLabel=" 向 下 移动 " 
rightUpLabel=" 向 上 移动 " 
rightDownLabel=" 向 下 移动 " 
/> 


</s:form> 

上 述 实例 使 用 了 optiontransferselect 标签 的 大 部 分 常用 属性 ， 比 如 : 用 来 控制 选项 移动 的 
按钮 、 按 钮 上 的 文本 设置 ， 等 等 。 

13. label 标 签 

xhtml 主题 提供 的 label 标签 输出 两 个 HTML 的 label 标签 ， 分 别 位 于 一 行 的 两 列 ， 左 列 的 
label 标签 起 提示 作用 ， 右 列 的 label 标签 用 于 显示 只 读 的 action 属性 数据 。 而 simple 主题 提供 
的 label 标签 只 输出 一 个 HIML label 标签 。 

label 标签 的 基本 用 法 如 下 。 

<s:label label=" 用 户 名 " name="username"/> 

如 果 请 求 的 Action 创建 了 实例 , 并 且 username 属性 有 值 , 将 在 右 列 的 标签 上 显示 usemame 
属性 的 值 。 

14. file 标 签 

file 标签 用 于 输出 一 个 HTML 文件 选择 框 ， 相 当 于 HTML 代码 : <input type="file" .../>。 

除了 公共 属性 外 ，file 标签 特有 的 属性 为 accept， 默 认 值 为 input， 这 个 属性 可 以 指出 接受 
的 文件 的 MIME 类 型 。 
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file 标签 的 基本 用 法 如 下 。 


<s:file name="uploadFile" accept="text/*" /> 


15. head 标 签 


head 标签 输出 对 应 主题 的 HEAD 部 分 的 内 容 。 如 果 有 些 主题 需要 包含 特定 的 CSS 和 
JavaScript， 可 以 使 用 head 标签 来 输出 这 些 代码 。 

除了 公共 属性 外 ，head 标签 特有 的 属性 如 表 8-31 所 示 。 

表 8-31 head 标 签 的 属性 
说 了 明 

如 果 使 用 ajax 主题 时 将 该 属性 设置 为 rue， 那 么 将 
开启 调试 模式 
jscalendar 控件 使 用 的 css 主题 


head 标签 的 基本 用 法 如 下 。 


<html> 
<head> 
<title>head 标签 </title> 
</head> 
<body> 
<s:head/> 
</body> 
</html> 


16. token 标 签 

token 标签 用 于 防止 多 次 提交 表单 (避免 刷新 页 面 时 多 次 提交 )， 如果 需要 该 标签 起 作用 ， 则 
应 该 在 Struts 2 的 配置 文件 中 启用 TokenInterceptor 拦截 器 ， 获 知 TokenSessionStoreInterceptor 
拦截 器 。 

token 标签 的 实现 原理 是 在 表单 中 添加 一 个 隐藏 域 ， 每 次 加 载 该 页 面 时 ， 该 隐藏 域 的 值 都 
不 相同 。TokenInterceptor 拦截 器 拦截 所 有 用 户 请 求 ， 如 果 两 次 请 求 时 该 token 对 应 隐藏 域 的 值 
相同 ， 则 阻止 表单 提交 。 

通过 上 面 的 介绍 可 以 看 出 ，token 标签 无 需 在 页 面 上 生成 任何 输出 ， 也 无 需 开 发 者 手动 控 
制 ， 因 此 使 用 该 标签 无 需 指 定 任何 属性 。 

在 默认 情况 下 ，token 标签 生成 的 隐藏 域 的 name 为 struts.token。 因 此 ， 不 要 在 表 
注意 单 中 再 定义 一 个 名 为 struts.token 的 表单 域 。 
token 标签 生成 一 个 阻止 重复 提交 的 隐藏 域 ， 基 本 用 法 如 下 。 


<s:token/> 


17. updownselect 标 签 


updownselect 标签 的 用 法 类 似 于 select 标签 ， 区 别 是 该 标签 生成 的 列表 框 可 以 支持 选项 的 


< 
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上 下 移动 。 因 此 使 用 该 标签 时 ， 一 样 可 以 指定 list、listKey 和 listValue 等 属性 ， 这 些 属性 的 作 
用 与 使 用 select 标签 时 指定 的 list、listKey 和 listValue 等 属性 完全 相同 。 当 提交 表单 时 ， 列 表 
框 中 选中 的 选项 将 被 提交 。 除 了 公共 属性 外 ，updownselect 标签 特有 的 属性 如 表 8-32 所 示 。 


表 8-32 updownselect 标 签 的 属性 
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属性 名 称 是 否 必需 | 默认 值 类 型 说 明 
指定 要 和 迭代 的 集合 ， 使 用 集合 中 的 元 素来 
Collection、Map、 
设置 各 个 选项 。 如 果 list 属性 的 值 是 一 个 
list 是 无 Enumeration 
Map， 则 Map 的 key 会 成 为 选项 的 value， 
Iterator 或 者 Array 
Map 的 value 会 成 为 选项 的 内 容 

i 否 无 有 指定 使 用 集合 中 对 象 的 某 个 属性 作为 选项 
a 的 内 容 。 该 属性 只 对 第 一 个 列表 框 起 作用 
et 否 无 指定 使 用 集合 中 对 象 的 某 个 属性 作为 选项 
Ee 的 value。 该 属性 只 对 第 一 个 列表 框 起 作用 
否 元 指定 当 用 户 选 择 了 header 选项 时 提交 的 值 ， 
Se 如 果 使 用 该 属性 ， 不 能 为 该 属性 赋 空 什 
headerValue 否 无 sti | 设置 header 选项 的 内 容 
emptyOption 否 false 是 否 在 header 选项 后 面 添 加 一 个 空 选项 
multiple 否 true 如 果 设 置 为 tue， 则 创建 一 个 多 选 列表 
size 看 无 指定 下 拉 框 可 显示 的 选项 个 数 
moveUpLabel 否 E 设置 “上 移 ” 按 钮 上 的 文本 ， 默 认 是 符号 
moveDownLabel | 否 x 3 设置 “下 移 ” 按 钮 上 的 文本 , 默认 是 ”符号 
selectAllLabel 否 * 一 设置 “全 选 ”按钮 上 的 文本 ， 默 认 是 * 符 号 
allowMoveUp 否 孝 是 否 显示 “上 移 ” 按 钮 ， 默 认为 tme 
allowMoveDown | 否 无 Boolean 是 否 显示 “下 移 ” 按 钮 ， 默 认为 tue 
allowSelectAll “| 否 无 是 否 显示 “全 选 ” 按 钮 ， 默 认为 true 


使 用 updownselect 标签 创建 一 个 可 以 上 下 移动 选项 的 列表 框 ， 代 码 如 下 所 示 。 


<s:head/> 
<s:form> 
<s:updownselect 
list="{' 打 网 球 ',' 打 棒球 ',' 踢 足球 ' }" 
name="tsports" 
headerKey="-1" 


-- 请 选择 ---" 


IE 


headerValue= 


emptyOption= 
moveUpLabel=" 上 移 " 
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moveDownLabel=" 下 移 " 
selectAllLabel=" 全 选 " 
VE 


</s:form> 


18. hidden 标 签 


hidden 标签 用 于 输出 一 个 HTML 隐藏 表单 元 素 ， 相 当 于 HTML 代码 : <input 
type="hidden" .../>。xhtml 主题 直接 从 simple 主题 继承 了 hidden_.ftl 模板 。xhtml 主题 中 hidden 
标签 与 其 他 的 标签 不 太一 样 ，hidden 标签 不 输出 表 行 。 另 外 ，hidden 标签 除了 公共 属性 外 ， 没 
有 自己 特有 的 属性 。 

hidden 标签 的 基本 用 法 如 下 所 示 。 


<s:hidden name="username" value="Jack" /> 


19. submit 标 签 


submit 标签 用 于 输出 一 个 提交 按钮 。submit 标签 和 form 标签 一 起 使 用 可 以 提供 异步 表单 
提交 功能 。submit 标签 可 以 输出 以 下 三 种 类 型 的 提交 按钮 : input、image 和 button。 
除了 公共 属性 外 ，submit 标签 自己 特有 的 属性 如 表 8-33 所 示 。 


表 8-33 submit 标 签 的 属性 


属性 名 称 说 明 
pe 设置 提交 按钮 的 类 型 ， 可 选 值 : input、 button、image 
设置 image 类 型 的 提交 按钮 的 图 片 地 址 ， 该 属性 对 
input 和 button 类 型 的 提交 按钮 无 效 
action 了 指定 处 理 请 求 的 Action 
method [| 指定 处 理 请 求 的 Action 的 方法 


创建 一 个 input 类 型 的 提交 按钮 ， 并 使 用 action 和 method 属性 分 别 指定 处 理 请 求 的 Action 
和 处 理 请 求 的 Action 的 方法 。 代 码 如 下 所 示 。 


<s:submit type="input" action="BookManager" method="addBook" label=" 添 加 "/> 
创建 button 类 型 的 提交 按钮 ， 与 input 类 型 的 差不多 ， 代 码 如 下 所 示 。 

<s:submit type="button" action="BookManager" method="addBook"” label=" 添 加 "/> 
创建 image 类 型 的 提交 按钮 ， 使 用 method 属性 ， 代 码 如 下 所 示 。 


<s:submit type="image" method=" register " src="images/register.gif" /> 


20. reset 标 签 


reset 标签 用 于 输出 一 个 重 置 按钮 ， 一 般 与 form 标签 结合 使 用 提供 表单 的 重 置 功能 。 

除了 公共 属性 外 ，reset 标签 自己 特有 的 属性 有 type， 它 的 默认 值 是 input， 可 以 用 来 指定 
丰 团 按钮 的 类 型 ， 可 选 值 为 input 和 button。 

reset 标签 的 基本 用 法 如 下 。 


< 


<s:reset value=" 重 置 "/> <! 一 默认 值 按钮 类 型 为 input --> 
<s:reset type="button" label=" 重 置 "/> 


如 果 采 用 默认 的 input 重 置 按钮 类 型 ， 只 能 通过 value 属性 来 设置 重 置 按钮 上 的 文本 。 
8.4.2 ”实例 描述 
页 面 中 表单 应 用 是 非常 频繁 的 ， 比 如 : 提交 一 些 用 户 注册 信息 、 用 户 登录 信息 ， 等 等 。 但 


使 用 一 般 的 HTML 代码 实现 看 起 来 又 太 凌 乱 ， 因 此 借助 于 Struts 2 提供 的 表单 标签 ， 可 以 更 灵 
活 地 生成 各 种 表单 。 本 节 实 例 将 介绍 如 何 使 用 Struts 2 表单 标签 来 实现 个 人 信息 表单 。 


8.4.3 ”实例 应 用 


【 例 8-3】 个 人 信息 表单 。 
(1) 新 建 一 个 PersonFormAction 类 ， 声明 username( 用 户 名 )、password( 密 码 )、truename( 真 
实 姓名 )、sex( 性 别 )、education( 学 历 )、province( 省 份 )、city( 城 市 ) 和 favorite( 爱 好 ) 属 性 ， 并 分 别 
为 这 些 属性 创建 get、set 方法 ， 重 写 继承 于 ActionSupport 类 的 execute0 方 法 ， 代 码 如 下 所 示 。 


public class PersonFormAction extends Actionsupport { 
private String username; // 用 户 名 
private String password; // 密 码 
private String truename; // 真 实 姓 名 
private String sex; // 性 别 
private String education; // 学 历 
private string province; // 省 份 
private string city; // 城 市 
private String favorite; // 爱 好 


// 下 面 是 属性 username、password、 truename、sex、education、 province、city 和 
favorite 的 get 


// 和 set 方法 ， 在 此 省 略 了 。 


public String execute () throws Exception{ 
return "success"; 
} 
a 


(2) 打开 项 目 目录 src/struts.xml 文件 ， 向 该 文件 中 添加 PersonFormAction 配置 ,代码 如 下 
所 示 。 
<package name="formtag" extends="struts-default"> 
<action name="personform" class="com.struts2.action.PersonFormAction"> 
<result>/personinfo.jsp</result> 
</action> 


</package> 


mm >> 
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(3) 新 建 一 个 formeljsp 页 面 ， 在 该 页 面 中 使 用 <s:form> 标 签 创建 一 个 form 表单 ， 并 使 用 
表单 元 素 标签 创建 一 些 表单 元 素 ( 文 本 输入 框 、 单 选 按钮 、 下 拉 列 表 框 ， 等 等 )， 以 供用 户 输入 
或 选择 相关 信息 。 代 码 如 下 所 示 。 

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 


<%@ taglib uri="/struts-tags" prefix="s" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 


<html> 
<head> 
<title> 表 单 标签 的 应 用 </title> 
</head> 
<body> 
<s:form action="personform"> 
<s:textfield name="username"” label=" 用 户 名 " /> 
<s:password name="password" label=" 密 码 "/> 
<s:textfield name="truename"” label=" 真 实 姓名 " /> 
<s:radio name="sex"” 1ist="{' 男 ', ' 女 '}"” label=" 性 别 "/> 
<s:select name="education"” label=" 最 高 学 历 " 
1ist="{f "高 中 "，' 大 学 "，' 硕 士 "，" 博 士 '] "> 
</s:select> 
<s:doubleselect label=" 请 选择 所 在 省 市 " 
name="province" 
list="{' 河 南 省 ', ' 浙 江 省 ' }" 
doubleName="city" 
doubleList="top==' 河 南 省 '?{' 郑 州 市 ', ' 巩 义 市 '} :{' 杭 州 市 ',' 温 州 市 
rj"> 
</s:doubleselect> 
<s:checkboxlist name="favorite" 
list="{' 书 法 ',' 听 音乐 ',' 跳 舞 ',' 看 书 '，' 弹 钢琴 '}" 
label=" 个 人 爱好 "> 
</s:checkboxlist> 
<s:submit value=" 提 交 "/> 
</s:form> 
</body> 
</html> 


(4) 新 建 一 个 personinfo.jsp 页 面 ， 用 于 显示 用 户 提 交 的 个 人 信息 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@ taglib uri="/struts-tags" prefix="s" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 个 人 信息 </title> 
</head> 
<body> 
你 提交 的 个 人 信息 如 下 所 示 : 
<table> 
<tr> 
<tq> 用 户 名 : </td> 


<td><s:property value="username"/></td> 


< 
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</tr> 
EE 
<td> 密 码 : </td> 
<td><s:property value="password"/></td> 
</tr> 
<tr> 
<tq> 真 实 姓名 : </td> 
<td><s:property value="truename"/></td> 
</Er> 
-| 
<tq> 性 别 : </tq> 
<td><s:property value="sex"/></td> 
</Er> 
<tr> 
<tq> 学 历 : </tq> 
<td><s:property value="education"/></td> 
<AEr 
< 
<td> 城 市 : </td> 
<td><s:property value="city"/></td> 
</tr> 
4 
<td> 爱 好 : </td> 
<td><s:property value="favorite"/></td> 
</tr> 
</table> 
</body> 
</html> 


8.4.4 运行 结果 


打开 焉 浏览 器 ,在 地 址 栏 中 输入 “http://localhost:8080/Struts2_8/formel.jjsp”， 用 户 可 以 在 
该 页 面 中 输入 或 选择 个 人 信息 ， 运 行 结果 如 图 8-7 所 示 。 

当 用 户 输入 个 人 信息 完毕 , 单 击 表单 的 “提交 ”按钮 ， 将 表单 提交 到 personform.action 上 ， 
该 Action 处 理 数据 成 功 之 后 ， 将 跳 转 到 personinfo.jsp 上 ， 显 示 用 户 的 个 人 信息 ， 执 行 效果 如 
图 8-8 所 示 。 


你 提交 的 个 人 信息 如 下 


图 8-7 个 人 信息 表单 图 8-8 个 人 信息 


三 
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8.4.5 实例 分 析 


ee 


在 本 实例 新 建 的 formel.jsp 页 面 中 ， 使 用 了 form 标签 和 表单 元 素 标签 (textfield 标签 、 
Password 标签 、select 标签 ， 等 等 ) 以 供用 户 填写 个 人 信息 。 

创建 了 一 个 PersonFormAction, 当 用 户 提交 表单 时 , 将 提交 给 PersonFormAction, 该 Action 
接受 了 用 户 提交 过 来 的 个 人 信息 ， 并 将 这 些 信息 赋 给 自己 的 属性 (ausermame、Ppassword， 等 等 )。 
当 用 户 请 求 PersonFormAction 成 功 之 后 ， 将 跳 转 到 personinfo.jsp 页 面 ， 在 该 页 面 上 使 用 
<s:property> 标 签 将 用 户 信 息 显 示 出 来 。 


8.5 选择 自己 喜欢 的 节日 


非 表 单 标签 主要 用 于 在 页 面 中 生成 一 些 非 表单 的 可 视 化 元 素 , 例如 Tab 页 面 、 输出 HTML 
页 面 的 树 形 结构 等 。 当 然 ， 非 表单 标签 也 包含 在 页 面 显示 Action 里 封装 的 信息 。 


得 ， i . 
下 = 视频 教学 : 光盘 /videos/08/component.avi 全 长 度 : 7 分 钟 
光盘 /videos/08/actionmessage.avi 人 长度: 4 分 钟 


8.5.1 基础 知识 一 一 非 表单 标签 


非 表单 标签 包括 : component、a、actionerror、actionmessage， 等 等 。 本 节 将 逐一 向 读者 讲 
解 这 些 标签 的 功能 及 使 用 方法 。 

1. component 标 签 

component 标签 用 于 使 用 自 定义 的 组 件 ， 这 是 一 个 非常 灵活 的 用 法 。 如 果 开 发 者 经 常 需要 
使 用 某 个 效果 片段 ， 就 可 以 考虑 将 这 个 效果 片段 定义 成 一 个 自 定义 组 件 ， 然 后 在 页 面 中 使 用 
component 标签 来 使 用 该 自 定义 组 件 。 

由 于 使 用 自 定义 组 件 是 基于 主题 与 模板 管理 的 ， 因 此 在 使 用 component 标签 时 ， 通 常 需要 
指定 如 表 8-34 所 示 的 属性 。 

表 8-34 component 标 签 的 属性 


属性 名 称 说 明 
自 定义 组 件 所 使 用 的 主题 ， 如 果 不 指定 该 属性 ， 则 默认 使 用 xhtml 主题 
指定 自 定义 组 件 的 主题 目录 ， 如 果 不 指定 ， 则 默认 使 用 系统 的 主题 目录 ， 即 template 
目录 
指定 自 定义 组 件 所 使 用 的 模板 


theme 


templateDir 


< 
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如 果 模 板 需要 传 入 某 些 外 部 对 象 ,可 以 在 component 标签 内 部 使 用 param 子 标签 来 传递 这 
些 对 象 。 如 果 在 模板 中 还 需要 取得 该 参数 ， 可 以 采用 ${parameters.key} 或 者 ${parameters. 
get(key)}。 如 果 是 JSP 模板 ， 可 以 通过 <s:property value="%{fparameters.key}"/> 或 者 <s:property 
value="%{fparameters.get(key)}"/> 来 获取 对 象 。 

在 Struts 2 中 ， 自 定义 组 件 可 以 使 用 FreeMarker、JSP 或 者 Velocity 来 编写 。 通过 文件 的 后 
级 可 以 找到 正确 的 呈现 引擎 。 


”如 果 使 用 JSP 页 面 作为 模板 ,那么 JSP 模板 文件 必须 位 于 Web 应 用 程序 本 身 的 目 
注意 录 中 ,而 不 能 放 到 CIASSPATH 下 , 否则 将 找 不 到 JSP 模板 .FreeMarker 和 Velocity 
模板 则 没有 这 个 限制 。 


2. a 标签 

a 标签 用 于 创建 一 个 HTML 超 链接 。 它 是 为 更 好 地 与 ajax 主题 一 起 使 用 而 设计 的 , 也 可 以 
在 simple、xhtml 和 其 他 主题 中 使 用 。 

a 标签 提供 了 一 个 String 类 型 的 href 属性 , 该 属性 可 以 指定 链接 的 URL 地 址 。 例 如 下 面 所 示 。 


<s:a href="addUser.action"> 添 加 用 户 </s:a> 


3. actionmessage、actionerror 和 fielderror 标 签 


actionmessage、actionerror 和 fielderror 标签 用 法 几乎 完全 一 样 。 它 们 都 是 用 于 输出 消息 的 ， 
区 别 是 actionmessage 用 于 输出 Action 实例 的 一 般 性 消息 ，actionerror 标签 用 于 输出 Action 实 
例 的 错误 消息 ，fielderror 标签 用 于 输出 Action 实例 字段 的 错误 消息 。 
actionmessage 标签 输出 的 是 ，Action 实例 的 一 个 Collection 类 型 的 属性 actionMessages 保 
存 的 消息 ，actionerror 标签 输出 的 是 ，Action 实例 的 一 个 Collection 类 型 的 属性 actionErrors 保 
存 的 错误 消息 , fielderror 标签 输出 的 是 ，Action 实例 的 一 个 Map 类 型 的 属性 fieldErrors 保存 的 
字段 错误 信息 。 
下 面 的 例子 中 首先 新 建 一 个 ErrorAction 类 ,在 这 个 Action 中 添加 一 些 Action 的 一 般 消息 、 
Action 的 错误 消息 和 Action 的 字段 错误 消息 。 代 码 如 下 所 示 。 
public class ErrorAction extends ActionSsupport{ 
public String execute() throws Exception{ 
// 添 加 Action 的 一 般 性 消息 
addActionMessage ("One Action Message"); 
addActionMessage ("Two Action Message"); 
// 添 加 Action 的 错误 消息 
addActionError ("One Error Action"); 
addActionError ("Two Error Action"); 
// 添 加 Action 字段 的 错误 消息 
addFieldError ("one Field","One Field Error"); 
addFieldError ("two Field","Two Field Error"); 
return "success"; 


ft) >> 
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接 下 来 编写 一 个 JSP 页 面 ， 使 用 actionmessage、actionerror 和 fielderror 标签 分 别 输出 
ErrorAction 中 添加 的 消息 ， 代 码 如 下 所 示 。 

<h3> 输 出 Action 的 一 般 性 消息 </h3> 
<s:actionmessage/> 
<h3> 输 出 Action 的 错误 消息 </h3> 
<s:actionerror/> 
<h3> 输 出 Action 所 有 字段 的 错误 消息 </h3> 
<s:fielderror/> 
<h3> 输 出 Action 的 one_Field 字段 的 错误 消息 </h3> 
<s:fielderror> 

<s:param value="'one Field'"></s:param> 
</s:fielderror> 


8.5.2 ”实例 描述 


在 Struts 2 中 ， 非 表单 标签 中 的 component 标签 提供 了 一 个 非常 灵活 的 用 法 ， 即 使 自 定义 
组 件 也 是 如 此 。 开 发 者 可 以 根据 自己 的 需要 编写 模板 文件 ， 从 而 使 页 面 显示 更 简洁 美观 、 并 能 
提高 开发 者 的 工作 效率 。 在 本 节 实 例 中 ， 将 向 读者 介绍 如 何 使 用 自 定义 组 件 。 


8.5.3 ”实例 应 用 


【 例 8-4】 选择 自己 喜欢 的 节日 。 

(1) 首先 新 建 一 个 Component 项 目 ， 然 后 在 该 项 目的 Component 目录 下 创建 
dayTemplateDir 目录 和 dayTheme 目录 ， 最 后 在 该 目录 下 新 建 一 个 FreeMarker 模板 文件 : 
ftlDayTemplatejsp 文件 ， 在 该 文件 中 写 入 如 下 代码 。 

<div style="color:red;"> 

<@s.select list="parameters.list"/> 

</div> 

(2) 在 项 目 dayTemplateDir/dayTheme 目录 下 , 新建 一 个 jspDayTemplate.jsp 模板 文件 ,在 
该 文件 中 写 入 如 下 代码 。 

<%@ page contentType="text/html; charset=UTF-8" language="java"%®> 

<%@taglib prefix="s" uri="/struts-tags" %> 

<div style="color:green;"> 

<b>JSP 自 定义 模板 <br> 

请 选择 您 喜欢 的 节日 <br></b> 

<s:select list="parameters.list"/> 
</div> 


(3) 在 项 目 Component 目录 下 依次 创建 template/xhtml 目录 ， 在 xhtml 目录 下 新 建 
myTemplate.jsp 模板 文件 ， 在 文件 中 写 入 如 下 代码 。 


<%@ page contentType="text/html; charset=UTF-8" language="java"%®> 
<%Q@taglib prefix="s" uri="/struts-tags" $%> 


< 
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<div style="color:red;"> 
<pb>JSP 自 定义 模板 <br> 
请 选择 您 喜欢 的 节日 <br></b> 


<s:select list="parameters.list"/> 


(4) 在 项 目 Component 目录 下 新 建 一 个 component.jsp 页 面 ， 在 该 页 面 中 使 用 component 
标签 输出 ftDayTemplate.fl 模板 、jspDayTemplate.jsp 模板 和 myTemplate.jsp 模板 。 代 码 如 下 
所 示 。 


<%@ page contentType="text/html; charset=UTF-8" language="java"%®> 
<%@taglib prefix="s" uri="/struts-tags"%®> 


<head> 


<title> 使 用 s:component 标签 </title> 


</head> 
<body> 


<h3> 使 用 s:component 标签 </h3> 

自 定义 主题 与 目录 <br/> 

FreeMarker 自 定义 模板 <br/> 

请 选择 您 喜欢 的 节日 <br/> 

<s:component 
theme="dayTheme" 
templateDir="dayTemplateDir" 
template="ftlDayTemplate"> 

<s:param name="list" 


value="{' 春 节 '，, ' 元 宵 节 ',' 端 午 节 ',' 七 夕 节 ',' 中 秋 节 ',' 重 阳 节 ' }" /> 


</s:component> 
<hr/> 
从 Web 应 用 根 路 径 下 加 载 模板 ， 使 用 JSP 模板 。 
<s:component 
theme="dayTheme" 
templateDir="dayTemplateDir" 
template="jspDayTemplate.jsp"> 
<s:param name="list" 


value="{' 春 节 ',' 元 宵 节 ',' 端 午 节 ', ' 七 夕 节 ',' 中 秋 节 ',' 重 阳 节 ' }" /> 


</s:component> 

<hr/> 

使 用 默认 主题 (xhtml) ， 默 认 主题 目录 (template) <br/> 

从 Web 应 用 中 加 载 模板 ， 使 用 JsP 模板 。 

<s:component template="mytemplate.jsp"> 
<s:param name="]list™" 


value="{' 春 节 ',' 元 宵 节 ',' 端 午 节 ',' 七 夕 节 ',' 中秋 节 ',' 重 阳 节 '}" /> 


</s:component> 

<hr/> 

使 用 自 定义 主题 ， 自 定义 主题 目录 <br/> 

从 /WEB-INF/classes 路 径 下 加 载 模板 ， 使 用 ftl 模板 。 
<s:component 


theme="myTheme™ 
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templateDir="myTemplateDir™" 
template="myAnotherTemplate"> 
<s:param name="l1ist" 
value="{' 春 节 ',' 元 宵 节 ',' 端 午 节 ',' 七 夕 节 ',' 中秋 节 ',' 重 阳 节 ' }" /> 
</s:component> 
</body> 
</html> 


8.5.4 ”运行 结果 


打开 正 浏 览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Component/component.jsp”， 执 行 
效果 如 图 8-9 所 示 。 


己 司 四 
-AE OIAV. "| 


££ 


使 用 s:component 标 答 
Cette 


web 本 用 央 反 司 下 和 理 匡 ， 他 用 全 本 
SP 入 定 多 者 
了 并 和 商 各 的 | 


SE 
全 更 主题 rn， EA (tomeene) 
ee 采用 中 全 国人 ， 刘 有 15P 人 和 
3SP 人 定妆 

wn 表 


人 站 二 文 是 站 二 文 许昌 上 有 
GT ,PA 


8-9 ”使 用 component 标 签 自 定义 组 件 


8.5.5 ”实例 分 析 


Ce 


上 述 实例 自 定义 了 一 个 FreeMarker 模板 文件 ，flDayTemplatefl、JSP 模板 文件 和 
jspDayTemplate.jsp， 使 用 默认 主题 xhtml 定义 了 一 个 JSP 模板 文件 myTemplate.jsp， 在 
fUDayTemplate.fl 文件 中 指定 了 文本 字体 颜色 为 红色 ， 并 接受 参数 list 节日 列表 ， 使 用 
<(@s.select> 来 加 载 list 列表 数据 , 使 用 户 可 以 选择 自己 喜欢 的 节日 。 jspDayTemplate.jsp 模板 文 
件 中 指定 了 文本 字体 颜色 为 绿色 ,同样 ， 获取 参数 list 节日 列表 ， 使 用 <s:select> 标 签 来 加 载 list 
列表 数据 ，myTemplate.jsp 文件 和 jspDayTemplate.jsp 差不多 ， 不 过 指定 文件 字体 颜色 为 红色 。 

有 了 前 面 的 三 个 模板 文件 ， 在 componentjsp 文件 中 就 可 以 使 用 component 标签 来 简单 地 
引用 这 些 模板 ,在 页 面 上 生成 节日 下 拉 选 择 框 ， 显 示 不 同 的 文本 字体 颜色 , 这 就 是 模板 的 作用 。 


< 
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8.6.1 Struts 2 一 遇 到 标签 就 出 错 


Struts 2 一 遇 到 标签 就 出 错 ， 怎 么 回 事 ? 
网 络 课 堂 : http://bbs.itzcn.com/thread-10925-1-1.html 


问 : 编写 JSP 程序 ， 但 是 一 遇 到 Struts 2 标签 就 出 现 如 下 错误 。 


HTTP Status 500 — 

type Exception report 

message 

description The server encountered an internal error () that prevented it from 
fulfilling this request. 

exception 

org.apache.jasper.JasperException: The Struts dispatcher cannot be found. This 
is usually caused by using Struts tags without the associated filter. Struts 
tags are only usable when the request has passed through its servlet filter, 
which initializes the Struts dispatcher needed for this tag. - [unknown location] 


【解决 办 法 】: 你 的 情况 是 由 于 Struts 2 的 标签 错误 导致 的 ， 所 以 首先 确保 在 开头 有 如 下 
代码 。 

<%@ taglib prefix="s" uri="/struts-tags" %> 

其 次 保证 必要 的 jar 包 的 导入 ， 最 后 保证 不 要 重复 导入 jar 包 ， 也 就 是 先 删 除 lib 下 的 所 有 
jar 包 ， 再 重新 导入 。 


8.6.2 Struts 标签 库 导 入 错误 


Struts 标签 库 导 入 错误 ? 
网 络 课堂 : http:Wbbs.itzcn.comy/thread-10927-1-1.html 

问 : 做 网 站 项 目 练习 ， 使 用 的 SSH， 在 导入 Struts 2 标签 库 struts-tags.tld 时 ， 出 现 红 又 ， 不 
能 正常 使 用 ， 应 该 怎样 导入 呢 ? 我 看 见 http://diaolanshan.javaeye.com/blog/243956 说 了 一 些 方 
法 ， 但 是 我 的 是 myeclipse， 不 是 eclipse， 其 实 windows-preference 中 没有 amateras 啊 ， 应 该 怎么 
导 ? 


【解决 办 法 】: Stmuts 2 的 标签 库 是 不 用 导 的 ， 已 经 存在 于 Struts 2 的 包 里 面 了 。 在 
struts2-core-2.xxxx.jar 下 的 META-INF 下 面 ， 只 要 配置 web.xml 中 Struts 2 本 来 的 配置 就 可 
以 了 ! 使 用 的 时 候 就 包含 如 下 代码 。 


<%@ taglib uri="/struts-tags" prefix="s" 和 > 


me >> 
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8.6.3 iterator 标 签 如 何 循环 遍历 某 一 实体 下 的 set 集 合 数据 


iterator 标签 如 何 循 环 遍历 某 一 实体 下 的 set 集合 数据 ? 
网 络 课堂 : http://bbs.itzecn.com/thread-10931-1-1.html 


问 : 本 人 初学 Struts 2 的 标签 不 是 很 会 使 用 , 希望 各 位 高 手 能 给 个 使 用 <s:iterator> 标 签 来 循 
环 遍历 某 一 实体 下 的 set 集合 数据 。 
【解决 办 法 】: 我 看 你 初学 ， 就 给 你 写 个 吧 。 
Pojo 实体 类 User。 


public class User 

和 
int id; 
string name; 
int age; 
string address; 


//getter and setter methods; 
} 
Dao 层 代 码 如 下 。 
Set<User> users = userDao.getAllUser();// 返 回 所 有 的 user 对 象 ， 并 封装 成 Set 集合 
Action 类 代码 如 下 。 
Set <User> users; 
UserDao userDao; 
//getter and setter 
public String getAllUser() 
1 
users = userDao.getAllUser (); 


return "success"; 
3 
jsp 页 面 代码 如 下 。 
<table> 
<tr> 
th> 用 户 ID</th> 
th> 用 户 名 </th> 
<th> 用 户 年 龄 </th> 
<th> 用 户 地 址 </th> 
x/Er> 
<s:iterator value="users"> 
<tr> 
<th>${id}</th> 
<th>$ {name}</th> 
<th>${age}</th> 


< 


ax 


<th>${address}</th> 
</tr> 
</s:iterator> 
</table> 


8.6.4 使 用 Struts 2 的 bean 标 签 出 错 


使 用 Struts 2 的 bean 标签 出 错 了 ， 求 高 手 帮忙 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10935-1-1.html 


问 : 在 Action 中 得 到 了 某 个 对 象 ， 该 对 象 有 两 个 属性 ， 其 中 first=20,last=25, 请 问 使 用 什 
么 方法 可 以 在 页 面 上 输出 如 下 数组 : 20，21，22，23，24，25。 
该 对 象 名 为 pager， 我 的 写法 如 下 ， 请 问 为 什么 会 报错 呢 ? 哪里 不 对 ? 


<s:bean name="org.apache.struts2.util.Counter" id="counter"> 
<s:param name="first" value="#pager.first" /> 
<s:param name="last" value="#pager.last" /> 
<s:iterator> 
counter:<s:property/> 
</s:iterator> 
</s:bean> 


【解决 办 法 】: 应 该 写 如 下 代码 。 


<s:bean name="org.apache.struts2.util.Counter" id="counter"> 
<s:param name="first" value="20" /> 
<s:param name="last" value="25" /> 
<s:iterator> 
counter:<s:property/> 
</s:iterator> 
</s:bean> 


8.6.5 Struts 2 的 验证 框架 ， 用 的 是 哪个 标签 返回 错误 信息 


Struts 2 的 验证 框架 ， 用 的 是 哪个 标签 返回 错误 信息 ? 
网 络 课堂 : http://bbs.itzen.com/thread-2976-1-1.html 


问 :本 人 初学 Struts 2 框架 ,对 其 标签 的 使 用 不 清楚 ,请 问 <s:actionerror/>、<s:actionmessage/> 
和 和 <s:fielderror/> 这 三 个 标签 分 别 是 干什么 用 的 ? 

Struts 2 的 验证 框架 ， 用 的 是 哪个 标签 返回 错误 信息 ? 

【解决 办 法 】: <s:actionerror/> 标 签 如果 在 Action 的 方法 中 通过 addActionError() 方 法 添加 
错误 信息 了 ， 那 么 此 标签 可 以 将 actionerror 中 的 错误 信息 显示 。actionerror， 即 Action 级 别 的 
背 误 。 

<s:fielderror> 标 签 如 果 通过 addFieldError0 方 法 添加 错误 ， 此 标签 可 以 将 其 显示 出 来 ， 

fielderror， 即 字段 级 错误 。 


mf >> 
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以 上 两 个 标签 都 不 推荐 使 用 。 
<s:actionmessage/> 才 是 正解 ， 可 以 通过 它 来 获取 Action 的 方法 中 返回 的 消息 。 
Struts 2 的 验证 框架 用 的 是 <s:fielderror> 标 签 返回 错误 信息 。 


8.6.6 <s:iterator> 标 签 循环 遍历 list 无 法 取出 类 型 为 类 的 属性 提示 
ognl.NoConversionPossible 错 误 


<s:iterator> 标签 循环 遍历 list 无 法 取出 类 型 为 类 的 属性 提示 
ognl.NoConversionPossible 错误 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10994-1-1.html 


问 : 初学 Struts 2， 遇 到 一 个 标签 问题 ， 求 助 高 手 ! 
-个 action 里 面 定义 了 一 个 List， 内 容 是 我 从 后 台 取 出 的 一 个 类 的 集合 。 该 类 中 包含 了 
个 自 定义 类 型 的 属性 。 在 前 台 用 <s:iterator> 标 签 循 环 遍 历 这 个 list， 可 以 取出 其 中 的 类 ， 和 类 的 
属性 ， 但 是 那个 类 型 为 类 的 属性 就 无 法 取得 ， 提 示 ognl.NoConversionPossible， 希 望 各 位 高 手 
可 以 指点 一 二 ! 
【解决 办 法 】: 你 需要 用 两 层 嵌 套 ， 第 二 层 是 那个 类 的 循环 。 这 是 我 写 过 的 一 个 jsp， 核 
心 代码 如 下 所 示 。 
<table border="0" cellpadding="5" cel1spacing="1"” bgcolor="#9AD6FA" 
width="100%"> 
<s:iterator value="dubList"> 
交友 于 科 
<td bgcolor="#2B6DA4" colspan="4"> 
<span class="style7"> 
<s:property value="name"/> 
</span> 
</td> 
</tr> 
<s:iterator value="list"> 
<tr bgcolor="#3383C3"> 
<td align="center" class="style8"><s:property 
value="name"/></td> 
<td align="center" class="style8"> 
<s:if test="role==''||role==null"> 


</s:if> 
<s:property value="role"/> 
</td> 
<td align="center" class="style8"> 
<s:if test="mail=="''||mail==null">---</s:if> 
<s:property value="mail"/> 
</td> 


<td align="center" class="style8"> 
< test— "status ><stexzt 
name="info.back.through"/></s:if> 


< 
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<s:else><s:text name="info.back.unexam"/></s:else> 
</td> 
</tr> 
</s:iterator> 
</s:iterator> 
</table> 


8.6.7 ”Struts 2 在 iterator 中 衬 套 radio 时 ，radio 标 签 该 怎么 写 


Struts 2 在 iterator 中 谱 套 radio 时 ，radio 标签 该 怎么 写 
网 络 课堂 : http://bbs.itzcn.com/thread-10995-1-1.html 


问 : 初学 Stuts 2， 想 在 iterator 中 嵌 套 使 用 radio 标签 ， 使 用 HTML 实现 代码 如 下 。 


<tr> 
<td width="10"><input type="radio" name="dc" value="1"></td> 
<td>00001</td> 
<tq> 数 据 中 心 01</tq> 

</tr> 

<tr> 
<td width="10"><input type="radio" name="dc" value="2"></td> 
<td>00002</td> 
<td> 数 据 中 心 02</td> 

</tr> 


现在 想 用 Struts 2 标签 实现 上 述 效果 ， 现 在 改 成 Struts 2 标签 ， 代 码 写成 如 下 所 示 。 


<s:iterator value="dcList" var="item" > 
<Er> 
<td width="10"> 
<s:radio name="item.dcradio" list="#item.dcradio"></s:radio> 
<td><s:property value="idcode"/></td> 
<td><s:property value="name"/></td> 
/> 
</s:iterator> 


action 里 定义 dcradio 为 boolean 型 ， 编 写 代码 后 ， 显 示 画 面 的 时 候 会 出 现 个 false， 请 高 手 
帮 帮 忙 解决 。 
【解决 办 法 】: 你 在 循环 里 面 生成 的 radio 的 name 名 称 不 能 都 一 样 。 如 果 name 都 一 样 的 
话 ， 就 会 出 现 对 所 有 相同 name 名 称 的 radio 只 能 选择 一 个 的 情况 。 所 以 必须 给 不 同 的 radio 指 
定 不 同 的 name。 


<s:iterator value="dcList" var="item" indexId="i"> 
<tr> 
<td width="10"><s:radio name="item.dcradio$ {i}" 
list="#item.dcradio"></s:radio> 
<td><s:property value="idcode"/></td> 
<td><s:property value="name"/></td> 
/Er 
</s:iterator> 


mS >> 
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8.7 习 题 
一 、 填 空 题 
(1) Struts 2 标签 库 中 的 标签 大 体 可 以 分 为 四 种 ， 分 别 是 数据 标签 、 、 表 单 标 
签 和 非 表单 标签 。 
(2) sort 标签 用 于 对 指定 的 集合 元 素 进行 排序 ， 进 行 排序 时 ， 必 须 提供 自己 的 排序 规则 ， 
即使 实现 自己 的 Comparator， 自 己 的 Comparator 需要 实现 接口 。 


(3) property 标签 的 作用 是 输出 value 属性 指定 的 值 ， 如 果 没 有 指定 value 属性 ， 则 默认 输 
出 的 值 。 
(4) set 标签 用 于 将 某 个 值 放 入 指定 范围 内 ， 例 如 application 范围 、session 范围 等 。 我 们 


可 以 使 它 的 属性 来 指定 所 要 放 的 范围 。 
(5) Stmuts 2 内 置 的 四 种 主题 分 别 是 simple、 、css_xhtml 和 ajax 主题 。 
二 、 选 择 题 


(1) 控制 标签 可 以 完成 输出 流程 控制 ， 例 如 分 支 、 循 环 等 操作 ， 也 可 完成 对 集合 的 合并 、 
排序 等 操作 。 下 面 属于 控制 标签 的 标签 有 哪些 ? 
A. a 标签 B. if/elseif/else 标签 C. html 标签 
D. submit 标签 E. url 标签 F. html 标签 
(2) append 标签 可 以 将 多 个 集合 对 象 拼接 起 来 , 组 成 一 个 新 的 集合 。 下 面 哪个 标签 可 以 为 
它 提供 需要 合并 的 多 个 子 集合 呢 ? 
A.，iterator 标签 B. merge 标签 
C.，subset 标签 D. param 标签 
(3) 数据 标签 用 于 访问 ActionContext 和 值 栈 中 的 数据 。 下面 哪个 数据 标签 可 以 将 某 个 值 
放 到 ValueStack 的 栈 顶 ? 


A. push 标签 B.，sort 标签 
C，set 标签 D.， property 标签 
(4) 下 面 对 <s:bean> 标 签 的 作用 描述 正确 的 是 
A. 引入 一 个 某 个 类 B. 创建 一 个 JavaBean 实例 
C. 为 JavaBean 实例 的 属性 赋值 D. 为 其 他 标签 提供 参数 
(5) 通过 指定 Action 的 名 字 和 可 选 的 名 称 空间 ，action 标签 允许 你 在 JSP 页面 中 直接 调用 
Action。 该 标签 的 属性 用 来 指定 要 调用 的 Action 。 
A. action B. value 
C. name D. id 
(6) 下 列 标签 用 于 将 一 个 JSP 页 面 ， 或 者 一 个 Servlet 包含 到 本 页 面 中 。 它 类 
似 于 JSP 中 的 <jsp:include> 标 签 。 
A.include 标签 B. file 标签 
C. ufl 标 签 D. text 标签 


< 多 mm 
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(7) 在 Stmts 2 的 数据 标签 中 的 标签 可 以 在 页 面 中 生成 一 个 Debug 超 链接 , 单 
击 这 个 超 链接 ， 可 以 查看 到 ValueStack 和 ActionContext 中 所 有 的 对 象 。 
A. text 标签 B. il8n 标签 
C. debug 标签 D. bug 标签 
(8) Struts 2 提供 了 3 种 方式 可 以 创建 一 个 新 的 主题 ， 下 面 正确 的 是 
A. 重新 创建 一 个 全 新 的 主题 B. 引入 其 他 框架 主题 
C. 结合 其 他 框架 主题 编写 一 个 新 主题 D. 删除 现 有 主题 的 一 部 分 得 到 新 主题 
(9) 下 面 属 于 表单 标签 的 标签 有 
A. form 标签 Biterator 标签 C. a 标签 
D. component 标签 E. debug 标签 F. url 标签 
(10) 下 面 我 们 使 用 标签 来 输出 一 个 HTML 单行 文本 输入 控件 ,相当 于 HTML 
代码 : <input type="text" .../>。 
A.，textfield 标签 B. text 标签 
C.，textarea 标签 D. label 标签 
(11) Struts 2 中 的 非 表 单 标签 中 的 标签 可 以 用 于 使 用 自 定义 的 组 件 。( 单 选 )C 
A. a 标签 B. actionmessage 标签 
C. component 标签 D.，actionerror 标签 


三 、 上 机 练习 

上 机 练习 : 选择 自己 喜欢 的 图 书 。 

练习 要 求 : 本 实例 首先 创建 一 个 JSP 页 面 ， 随 意 取 名 如 : select_book.jsp。 在 该 页 面 中 使 用 
<s:select> 标 签 生成 一 个 下 拉 选 择 框 ， 并 指定 它 的 list 属性 加 载 一 个 图 书信 息 列 表 ， 使 用 
<s:optgroup> 标 签 为 下 拉 列 选择 框 创建 选项 组 ， 在 下 拉 列 选择 框 中 分 组 显示 图 书信 息 。 执 行 效 
果 如 图 8-10 所 示 。 


图 8-10 选择 自己 喜欢 的 图 书 


ml >> 
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内 容 摘要 : 

文件 上 传 是 Web 应 用 经 常 需要 面 对 的 问题 。 大 多 数 情况 下 ， 用 户 的 请 求 参数 是 在 表单 域 
输入 的 字符 串 ， 但 如 果 为 表单 元 素 设 置 enctype=“multipartform-data” 属性 ， 则 提交 表单 时 不 
再 以 字符 串 方式 提交 参数 ， 而 是 以 二 进 制 编码 的 方式 提交 请 求 。 此 时 直接 通过 
HttpServletRequest 的 getParameter() 方 法 无 法 正常 获取 请 求 参 数 的 值 ， 可 以 通过 二 进 制 流 来 获 
取 请 求 内容 一 一 通过 这 种 方式 ， 就 可 以 取得 希望 上 传 文件 的 内 容 ， 从 而 实现 文件 的 上 传 。 

上 面 介 绍 的 文件 上 传 方式 是 全 手工 的 文件 上 传 机 制 ， 这 种 方式 编程 麻烦 ， 而 且 需 要 全 手动 
控制 二 进 制 流 ， 过 程 繁 琐 。Struts 2 对 此 提供 了 相应 的 解决 方案 。 

在 一 些 网 络 系统 中 ， 需 要 隐藏 下 载 文件 的 真实 地 址 ， 或 者 将 下 载 的 数据 存放 在 数据 库 中 ， 
那么 可 以 通过 编程 来 实现 文件 的 下 载 ， 还 可 以 对 下 载 文件 添加 访问 控制 。 

本 章 将 介绍 如 何在 Struts 2 中 实现 文件 的 上 传 和 下 载 。 

学 习 目标 : 
掌握 如 何在 Struts 2 中 实现 文件 上 传 。 
掌握 如 何 过 滤 文 件 上 传 的 类 型 和 大 小 。 
掌握 如 何在 Struts 2 中 实现 文件 下 载 。 
热 练 同时 上 传 多 个 文件 的 步骤 。 


is 2 Web 开发 学 习 实录 … 皇 


9.1 文件 上 传 的 原理 


在 网 络 上 遇 到 许多 朋友 询问 文件 上 传 的 问题 ,他们 的 问题 或 许 千奇百怪 , 但 主要 原因 都 是 
因为 不 了 解 文件 上 传 的 原理 。 本 节 将 从 文件 上 传 的 底层 机 制 讲 起 , 希望 帮助 读者 彻底 解决 文件 
上 传 的 问题 。 


9 
是 视频 教学 ， 光盘 /videos/09/form.avi 各 长 度 : 6 分 钟 


在 早期 的 HTML 中 ， 表 单 不 能 实现 文件 的 上 传 ， 这 多 少 限制 了 一 些 网 页 的 功能 。1995 年 
11 月 发 布 的 RFC1867 规范 ( 即 HTML 中 基于 表单 的 文件 上 传 ) 对 表单 做 了 扩展 ， 增 加 了 一 个 表 
单元 素 (<input type= file">)。 如 果 在 表单 中 使 用 了 这 个 元 素 ， 浏 览 器 在 解析 表单 时 ， 会 自动 生 
成 一 个 输入 框 和 一 个 按钮 。 输 入 框 可 供用 户 填写 本 地 文件 的 文件 名 和 路 径 ， 按 钮 可 以 让 浏览 器 
打开 一 个 文件 选择 框 供 用 户 选 择 文件 。 这 就 是 上 传 文件 的 起 源 。 

1. 表单 元 素 的 enctype 属 性 

大 多 数 情况 下 ， 无 需 设置 表单 元 素 的 enctype 属性 ， 只 需 设 置 表单 的 action 属性 和 method 
属性 即 可 。 其 中 action 属性 指定 了 表单 提交 到 的 URL，method 属性 指定 是 以 POST 方式 还 是 
以 GET 方式 提交 请 求 。 

表单 的 enctype 属性 指定 的 是 表单 数据 的 编码 方法 ， 该 属性 有 如 下 三 个 值 。 

application/x-www-form-urlencoded 

这 是 默认 的 编码 方式 ， 它 只 处 理 表 单 域 里 的 value 属性 值 ， 采 用 这 种 编码 方式 的 表单 会 将 
表单 域 的 值 处 理 成 URL 编码 方式 。 

multipart/form-data 

这 种 编码 方式 会 以 二 进 制 流 的 方式 来 处 理 表单 数据 , 这 种 编码 方式 会 把 文件 域 指定 文件 的 
内 容 也 封装 到 请 求 参数 里 。 

text/plain 


该 编码 方式 在 表单 的 action 属性 为 mailto:URL 形式 时 比较 方便 ， 这 种 方式 主要 使 用 于 直 
接 通 过 表单 发 送 邮 件 的 方式 。 
下 面 以 一 个 简单 的 HTML 页 面 为 例 ， 来 介绍 enctype 属性 为 application/x-www-form- 
urlencoded 和 multipart/form-data 时 的 差别 。 
1) ”表单 的 enctype 为 application/x-www-form-urlencoded 
创建 一 个 简单 的 表单 输入 页 面 ， 代 码 片段 如 下 所 示 。 
<form action="form success.jsp" method="post" 
enctype="application/x-www-form-urlencoded"> 
上 传 文件 : <input type="file" name="file"><br> 
请 求 参数 : <input type="text" name="paramNum"><br> 
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<input type="submit" value="” 提交 " align="center" id=”submit”> 
</form> 
上 面 表单 的 enctype 属性 为 application/x-www-form-urlencoded, 这 是 enctype 属性 的 默认 值 。 
如 果 不 指 定 该 属性 值 ， 系 统 默认 以 application/x-www-form-urlencoded 作为 该 属性 的 值 。 该 页 
面 的 运行 效果 如 图 9-1 所 示 。 


基于 表单 的 文件 上 传 
rev soem wo mm em moe 


Et | 


ET ] 


9-1 包含 文本 框 和 文件 域 的 表单 


由 于 本 应 用 主要 用 于 分 析 表 单元 素 的 enctype 属性 , 所 以 直接 使 用 JSP 页 面 来 处 理 该 请 求 。 
正如 上 面 页 面 代码 所 实现 的 ， 该 请 求 提交 到 form_success.jsp 页 面 ， 该 页 面 的 代码 内 容 如 下 。 
<%@ page language="java" import="java.io.*" pageEncoding="gbk"%> 
< 多 
// 获 取 HTTP 请 求 的 输入 流 
InputStream is=Tequest .getInputStream() 7 


// 以 HTTP 请 求 输入 流 建 立 一 个 BufferedReader 对 象 


BufferedReader br=new BufferedReader (new InputStreamReader (is)); 


// 读 取 HTTP 请 求 内 容 

String buffer=null; 

whilel( (buffer=br.readLine())!=null) 
4 


// 在 页 面 中 显示 读 取 到 的 请 求 参数 
out .println (buffer+"<br>"); 
%> 
显然 , 上面 的 处 理 页 面 直接 通过 二 进 制 流 来 处 理 该 HTTP 请 求 一 一 这 是 一 种 更 底层 的 处 理 
方式 。 当 通过 HttpServletRequest 的 getParameter 方法 来 获取 请 求 参 数 时 ， 实 际 上 是 Web 服务 
器 蔡 我 们 处 理 了 这 种 底层 的 二 进 制 流 ， 并 将 二 进 制 流转 换 成 对 应 的 请 求 参数 值 。 
如 果 在 如 图 9-1 所 示 页 面 的 文件 上 传 域 中 选中 要 上 传 的 图 片 ,并 在 下 面 的 输入 框 中 输入 “这 
是 一 棵 树 ”， 然 后 单 击 “ 提 交 “ 按 钮 ， 将 会 看 到 如 图 9-2 所 示 的 页 面 。 


< 


图 9-2 以 application/x-www-form-urlencoded 方 式 提 交 请 求 

从 图 9-2 可 以 看 出 ， 即 使 通过 底层 的 二 进 制 输入 流 ， 一 样 可 以 读 到 该 请 求 的 内 容 : 一 个 普 

通 的 字符 串 ， 整 个 普通 字符 串 包 含 了 三 个 请 求 参 数 ， 即 file、paramNum 和 submit。 
$ 即使 是 表单 元 素 里 的 “提交 ”按钮 ， 表 单一 样 将 其 当成 一 个 表单 域 ， 一 样 转换 成 
组 未 | 。 一 个 请 求 参数 。 

大 部 分 时 候 , 程序 中 直接 通过 HttpServletRequest 的 getParameter 方法 即 可 获得 正确 的 请 求 
参数 ， 而 底层 的 二 进 制 流 处 理 和 使 用 URLDecoder 处 理 请 求 参 数 ， 都 由 Web 服务 器 完成 了 。 
因此 ， 如 果 将 form_success.jsp 页 面 的 代码 改 为 如 下 简单 形式 。 


<%@ page language="java" pageEncoding="gbk"%> 
< 多 


// 设 置 HttpservletRequest 使 用 GBK 的 编码 方式 
request.setCharacterEncoding ("GBK"); 
// 直 接 在 页 面 上 输出 两 个 请 求 参数 值 
out.println ("paramNum 请 求 参数 的 值 为 
"+request .getParameter ("paramNum")+"<br>"); 
out.println ("file 请 求 参 数 的 值 为 
"+request .getParameter ("file")+"<br>"); 
%> 


此 时 再 次 运行 程序 ， 将 看 到 如 图 9-3 所 示 的 页 面 。 


图 9-3 直接 获取 请 求 参 数 的 值 


mm >> 
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以 上 非常 详细 地 介绍 了 当 enctype 属性 为 “application/x-www-form-urlencoded” 时 的 作用 。 
显然 ， 如 果 设 置 该 表单 的 enctype 为 “application/x-www-form-urlencoded”， 则 无 法 实现 文件 
上 传 ， 为 了 实现 文件 上 传 ， 必 须 设 置 enctype 属性 为 “multipart/form-data”。 

2) “表单 的 enctype 为 multipart/form-data 

将 表单 提交 页 面 中 的 enctype 属性 设置 为 “multipart/form-data”， 并 把 form_success.jsp 页 
面 的 代码 改 为 前 面 直接 使 用 三 进 制 流 处 理 的 代码 , 该 请 求 将 会 把 文件 域 里 浏览 到 的 文件 内 容 作 
为 请 求 参数 发 送 。 显 然 ， 此 时 无 法 直接 通过 requestgetParameter() 方 法 来 获取 请 求 参数 。 


5 一 旦 设置 了 表单 的 enctype=“multipart/form-data” 属 性 ， 就 将 无 法 通过 HttpServlet 
注意 Request 对 象 的 getParameter() 方 法 取得 请 求 参 数 。 


2. 手动 上 传 

通过 底层 的 二 进 制 流 来 取得 上 传 的 文件 内 容 ， 并 将 该 文件 内 容 放 到 Web 应 用 所 在 路 径 下 ， 
从 而 实现 文件 上 传 。 

对 于 每 个 文件 域 而 言 ， 总 会 有 包含 “filename=“xxx”” 的 字符 串 …… 可 以 根据 这 些 规律 来 
处 理 文件 的 上 传 ， 下 面 是 处 理 文件 上 传 的 JSP 页 面 代码 。 


<%@ page language="java" import="java.io.*" pageEncoding="gbk"g> 
<% 
// 取 得 HttpservletRequest 的 Inputstream 输 入 流 
Inputstream is=request.getInputstream(); 
// 以 Inputstream 输入 流 为 基础 ， 建 立 一 个 BufferedReader 对 象 
BufferedReader br=new BufferedReader (new InputStreamReader (is)); 
String buffer=null; 
// 循 环 读 取 请 求 内 容 的 每 一 行内 容 
whilel( (buffer=br.readLine())!=null){ 
DL I LA SE DA 开始 ， 且 以 -- 结 束 ， 
表 名 已 到 请 求 内 容 尾 
if(buffer.endsWith("--") && 
buffer. 3 七 SEES 大 站 蕊 了 二 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 人， 
{ 
// 跳 出 循环 


break; 


} 

A 和 果 读 到 的 内 办 以 -== 开始 ， 表 名 开始 了 
一 个 表单 域 

if(buffer.startsWith("----------------------------- ")) 


// 如 果 下 一 行内 容 中 有 filename 字符 串 ， 表 明 这 是 一 个 文件 域 
if(br.readLine() .indexof("filename")>l) 
// 跳 过 两 行 ， 开 始 处 理 上 传 的 文件 内 容 
br.readLine(); 
br.readLine(); 
// 以 系统 时 间 为 文件 名 ， 创 建 一 个 新 文件 


Fie £1le= ne 


< 


Sthuts 人 Web 开发 学 习 实录 - 必 


FEile (request.getRealPath("/")+SYstem-currentTimeMillis())7 
// 创 建 一 个 文件 输出 流 


PrintStream Ps=new PrintStream (newW 


FileOutputstream(file)); 
String content=null; 


// 接 着 开始 读 取 文 件 内 容 
whilel( (content=br.readLine())!=null) 
1 
// 如 果 读 取 的 内 容 以 
>- 开始 ， 表 明 开始 了 下 一 个 表单 域内 容 


// 跳 出 处 理 


break; 


} 
// 将 读 到 的 内 容 输出 到 文件 中 


ps.println(content); 


} 

// 关 闭 输 出 
ps.flush(); 
ps.close(); 


} 
} 
br.close(); 
%> 
通过 上 面 的 JSP 页 面 ， 可 以 将 一 个 文件 上 传 到 Web 应 用 的 根 路 径 下 。 值 得 注意 的 是 ， 在 
这 里 使 用 的 是 BufferedReader 字符 流 (字符 流 在 处 理 二 进 制 文件 时 会 出 现 问题 )， 因 此 上 面 的 上 
传 文件 仅 能 处 理 文本 文件 的 上 传 。 
上 面 的 上 传 处 理 页 面 不 是 一 个 非常 完善 的 上 传 处 理 ， 因 为 它 只 能 处 理 文本 文件 的 
注意 | 。 上 传 。 


当然 ， 如 果 将 上 面 采用 字符 流 处 理 文件 上 传 的 罗 辑 ， 改 为 以 字 节 流 来 处 理 文件 上 传 ， 则 上 
传 处 理 将 可 以 处 理 任何 文件 的 上 传 。 

对 于 一 个 成 熟 的 文件 上 传 框架 而 言 , 它 需 要 的 逻辑 非常 简单 : 通过 分 析 HttpServletRequest 
的 二 进 制 流 ， 解 析出 二 进 制 流 中 所 包含 的 全 部 表单 域 ， 分 析出 每 个 表单 域 的 类 型 (是 文件 域 或 
普通 表单 域 )， 并 允许 开发 者 以 简单 的 方式 来 取得 文件 域 的 内 容 字 节 、 文 件 名 和 文件 内 容 等 信 
息 ， 也 可 以 取得 其 他 表单 域 的 值 。 


9.2 Struts 2 中 的 文件 上 传 


Struts 2 并 未 提供 自己 的 请 求解 析 器 。 也 就 是 说 ，Struts 2 不 会 自己 去 处 理 multipart/form- 
data 的 请 求 ， 它 需要 调用 其 他 请 求解 析 器 ， 将 HITP 请 求 中 的 表单 域 解析 出 来 。 但 Stmts 2 在 


mm >> 


第 9 章 轻松 实现 文件 上 传 和 下 载 上 


原 有 的 上 传 解析 器 基础 上 做 了 进一步 封装 ， 更 进一步 简化 了 文件 的 上 传 功能 。 
下 面 就 介绍 一 下 Struts 2 对 文件 上 传 的 支持 和 如 何在 Struts 2 中 实现 文件 的 上 传 功能 。 


9 
= 视频 教学 : 光盘 /videos/09/struts2_upfile.avi 全 长 度 : 11 分钟 


9.2.1 基础 知识 


Struts 2 对 文件 上 传 的 支持 


通过 上 一 节 的 讲解 , 了 解 到 上 传 文件 的 内 容 不 能 直接 通过 请 求 对 象 的 getParameter() 方 法 来 
得 到 ， 需 要 以 字 节 流 的 方式 读 取 客 户 端 提交 的 文件 数据 ， 并 按照 文件 上 传 的 格式 对 这 些 数 据 进 
行 解析 ， 从 而 获取 上 传 文件 的 内 容 。 那 么 ，Struts 2 对 文件 上 传 的 支持 是 怎样 的 呢 ? 

Struts 2 本 身 没 有 提供 解析 上 传 文件 内 容 的 功能 ， 它 使 用 第 三 方 的 文件 上 传 组 件 提供 对 文 
件 上 传 的 支持 。Struts 2 默认 使 用 的 上 传 组 件 是 Apache 组 织 的 commons-fileupload 组 件 ， 该 组 
件 性 能 优异 ， 而 且 支持 任意 大 小 文件 的 上 传 。Struts 2 还 支持 两 种 文件 上 传 组 件 : pell 和 cos， 
可 以 通过 配置 struts.multipart.parser 属性 来 切换 Struts 2 使 用 的 上 传 组 件 。 


”对 于 Struts 2 使 用 的 上 传 组 件 ， 推 荐 读者 使 用 commons-fileupload 组 件 ， 该 组 件 是 
明示 | 。 目前 最 好 的 。 


commons-fileupload 组 件 的 下 载 网 址 是 : http://commons.apache.org/fileupload/， 本 书 使 用 的 
版 本 是 1.2.2。 下 载 它 的 Binary 压缩 包 (commons-fileupload-1.2.2-bin.zip)， 解 压缩 后 的 目录 中 有 
两 个 子 目 录 : lib 和 site。lib 目录 下 有 一 个 JAR 文件 一 一 commons-fileupload-1.2.2.jar 文件 ; site 
目录 中 是 commons-fileupload 组 件 的 文档 ， 其 中 也 包含 了 API 文档 。 

commons-fileupload 组 件 从 1.1 版 本 开始 依赖 于 Apache 的 另外 一 个 项 目 : commons-io， 它 
的 下 载 网址 是 ，http://commons.apache.org/io/， 本 书 使 用 的 版 本 是 2.0。 下 载 它 的 Binary 压缩 包 
(commons-io-2.0-bin.zip)， 解 压缩 后 的 目录 有 三 个 JAR 文件 ， 如 下 所 示 。 

@ commons-io-2.0.jar: 这 是 commons-io 的 类 库 。 

@ commons-io-2.0-javadoc.jar: 这 是 commons-io 的 API 文档 的 压缩 包 。 

@@ ”commons-io-2.0-sources.jar: 这 是 commons-io 的 源 代码 的 压缩 包 。 

Struts 2 提供 了 一 个 文件 上 传 拦截 器 : org.apache.struts2.interceptor.FileUploadInterceptor， 
它 负责 调用 底层 的 文件 上 传 组 件 解 析 文 件 内 容 , 并 为 Action 准备 与 上 传 文件 相关 的 属性 值 。 处 
理 文件 上 传 请 求 的 Action 必须 提供 特殊 样式 命名 的 属性 , 例如 , 假设 表单 中 文件 选择 框 (<input 
type=“file” name=“image”>) 的 名 字 是 image， 那 么 Action 应 该 提供 下 列 三 个 属性 。 

@ image: java.io.File 类 型 ， 已 上 传 文件 的 File 对 象 。 

@ imageFileName: 上 传 文件 的 文件 名 。 

@ imageContentType: 上 传 文件 的 内 容 类 型 (MIME 类 型 )。 

这 三 个 属性 的 值 会 由 FileUploadInterceptor 拦截 器 准备 。 


9.2.2 ”实例 描述 


最 近 公 司 接 了 一 个 OA( 办 公 自 动 化 ) 系 统 项 目 ， 既 然 是 OA 系统 ， 文 档 管理 模块 必 不 可 少 。 


< 
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具体 要 求 就 是 能 上 传 kt、doc、jpg、gif…… 类 型 的 文件 。 客 户 的 要 求 很 “独特 ”， 不 仅 要 求 
要 有 “前 台 ” 还 要 有 一 个 “后 台 ”， 本 着 客户 就 是 上 帝 的 宗旨 ， 公 司 承 诺 做 出 一 个 完整 的 OA 
系统 。 

在 此 ， 我 就 给 读者 分 享 一 下 “前 台 ” 中 的 上 传 文档 功能 。 


9.2.3 ”实例 应 用 


【 例 9-1】 OA 系统 “前 台 ” 上 传 文档 。 
(1) 编辑 上 传 文件 的 Action 类 (FileUploadAction.java), 在 其 内 定义 三 个 变量 , 分 别 代 表 上 
传 文件 的 file 对 象 、 上 传 文件 名 、 上 传 文件 的 MIME 类 型 ， 并 重 写 父 类 的 execute0 方 法 ， 把 上 
传 的 文件 保存 至 WEB-INF/UploadFiles 文件 夹 下 。FileUploadAction 类 的 内 容 如 下 。 


package com.struts2.actions; 
import java.io.BufferedInputstream; 
import java.io.BufferedOutputStream7 
import java.io.File; 
import java.io.FileInputstream; 
import java.io.FileOutputstream; 
import java.io.IOException; 
import java.util.Date; 
import org.apache.struts2.ServletActionContext; 
import com.opensymphony.xwork2.Actionsupport; 
/*# 
* 文件 上 传 Action 类 
* @author Administrator 
大 
*/ 
public class FileUploadAction extends ActionSsupport 
// 代 表 上 传 文件 的 file 对 象 
private File file; 
// 上 传 文件 名 
private String fileFileName; 
// 上 传 文件 的 MIME 类 型 


private String fileContentType; 


// 上 传 文件 的 描述 信息 
private String description; 
// 保 存 上 传 文件 的 目录 ， 相 对 于 Web 应 用 程序 的 根 路 径 ， 在 struts . xml 文件 中 配置 
private String uploadDir; 
@Override 
public String execute() throws Exception { 
String newFileName=null; 
// 得 到 当前 时 间 自 1990 年 1 月 1 日 0 时 0 分 0 秒 开始 流逝 的 毫秒 数 ， 将 这 个 毫秒 数 作为 
上 传 文件 的 新 文件 名 
long now=new Date() .getTime(); 


// 得 到 保存 上 传 文件 的 目录 的 真实 路 径 
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String 
Path=SerVletRActionContext -getServletContext () .getRealPath (uploadDir); 
File dir=new File(path) 7 
// 如 果 这 个 目录 不 存在 ， 则 创建 它 
if(!dir.exists()){ 
dir.mkdir(); 
} 
int index=fileFileName.lastIindexOf('.'); 
// 判 断 上 传 文件 名 是 否 有 扩展 名 ， 以 时 间 截 取 为 新 的 文件 名 
if(index!=-1){ 
newFileName=now+fileFileName.substring (index); 
上 下 Se 
newFileName=Long.toString (now) 
) 
BufferedoutputStream bos=null; 
BufferedInputStream bis=null; 
// 读 取保 存在 临时 目录 下 的 上 传 文件 ， 写 入 新 的 文件 中 
try{ 
FileInputStream fis=new FileInputstream(file); 
bis=new BufferedInputStream(fis) 


FileOutputStream fos=new FileOutputSstream(new 
Filel(dir,newFileName)); 
bos=new BufferedOoutputstream(fos); 


byte[] buf=new byte[4096]; 


int len=-1; 
while( (len=bis.read(buf))!=-1){ 
bos.write (buf,0,1en); 
} 
}finally{ 
tevt 
if(null!=bis){ 
bis.close(); 
} 
}catch (IOException ex){ 
ex.printstackTrace (); 
} 
try{ 
if (null!=bos){ 
bos.close(); 
} catch (IOException ex) { 
ex.printstackTrace (); 


} 
return SUCCESS; 
} 
/* 下 面 是 上 面 所 有 属性 的 set 、get 方法 ， 这 里 省 略 */ 


怀 人 mm 
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(2) 在 项 目 src 目录 下 新 建 struts-config 文件 夹 ， 在 其 内 新 建 fileupload.xml 文件 ， 配 置 
FileUploadAction 类 。 配 置 如 下 代码 。 


<package name="upload" namespace="/upload" extends="fileupload"> © 
<action name="upload" class="com.struts2.actions.FileUploadAction"> 
<result name="success">/success.jsp</result> 
<!-- 动 态 配置 图 片 的 存放 位 置 --> 
<param name="uploadDir">/WEB-INF/UploadFiles</param> © 
</action> 
</package> 


在 @ 处 ， 读 者 看 到 配置 package 时 ，extends 的 值 为 fileupload，fileupload 是 在 struts.xml 
文件 中 的 package 的 name 值 ， 在 这 个 文件 中 ， 继 承 了 struts.xml 文件 中 的 命名 空间 。 

在 @ 处 ， 在 配置 文件 中 设置 保存 上 传 文件 的 目录 。 在 Action 映射 中 ， 可 以 使 用 <param> 元 
素来 设置 Action 的 属性 值 , 由 staticParams 拦截 器 提供 支持 ,这 个 拦截 器 已 经 包含 在 defaultStack 
拦截 器 栈 中 。 


FileUploadInterceptor 拦截 器 已 经 在 struts-default.xml 文件 中 定义 (拦截 器 名 为 
注意 | ”fileUpload)， 并 且 已 被 包含 在 defaultStack 拦截 器 栈 中 ， 所 以 不 需要 再 单独 配置 对 
它 的 引用 了 。 


(3) 把 包 eupload.xml 文件 引入 struts.xml 文件 中 ，struts.xml 文件 内 容 如 下 。 


<?xml] version="1.0" encoding="UTF-8" ?> 
<!-- 指定 拦截 器 的 DTD 信息 --> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<!-- 通过 常量 配置 struts 2 所 使 用 的 解码 集 --> 
<constant name="struts.il8n.encoding" value="gbk" /> 
<constant name="struts.devMode" value="true" /> 
<!-- 把 fileupload.xml 文件 引入 到 本 文件 中 --> 
<include file ="struts-config/fileupload.xml" /> 
<package name="fileupload" namespace="/fileupload" 
extends="struts-default"> 
</package> 
</struts> 


(4) 在 WebRoot 下 创建 上 传 文件 页 面 fleupload.jsp。 代 码 片段 如 下 。 


<%Q@taglib prefix="s" uri="/struts-tags"%®> 
<s:form action="upload/upload.action" method="post" 
enctype="multipart/form-data"> 

<s:file name="file" label=" 请 选择 上 传 的 文件 ” /> 

<s:textarea name="description" cols="50" rows="10" label=" 文 件 描述 
"></astextareax 

<s:submit value=" 上 传 " align="center" cssClass="button"*/> 


</s:form> 


qeM 
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(5) 继续 创建 上 传 成 功 页 面 successjsp 页 面 ， 在 页 面 中 输出 上 传 文件 的 文件 名 、 文 件 类 型 
和 文件 描述 内 容 。 


9.2.4 ”运行 结果 


运行 fleupload.jsp 页 面 ， 上 传 一 张 图 片 。 如 图 9-4 所 示 。 
单 击 界面 中 的 “上 传 ”按钮 ， 转 至 SUCCESS 对 应 的 上 传 成 功 页 面 (seccess.jsp)。 如 图 9-5 
所 示 。 


图 9-4 文件 上 传 界面 图 9-5 上 传 成 功 界面 


9.2.5 ”实例 分 析 


a 


上 例子 中 ， 在 fileupload.xml 文件 中 以 <param name="uploadDir">/WEB-INF/UploadFiles 
</param> 动 态 的 设置 了 FileUploadAction 类 中 的 uploadDir 的 值 ,其 实 也 可 以 在 FileUploadAction 
中 初始 化 uploadDir 的 值 。 之 所 以 在 配置 文件 中 动态 设置 是 为 了 后 期 的 维护 ， 如 果 不 想 把 上 传 
的 文件 保存 入 这 个 文件 夹 路 径 下 了 ， 只 需要 修改 一 下 fileupload.xml 文件 即 可 。 


9.3 上传 文件 过 滤 


大 多 数 时 候 ，Web 应 用 不 允许 浏览 者 自由 上 传 ， 尤 其 不 允许 上 传 可 执行 性 文件 (因为 可 能 
是 病毒 程序 )。 通 常 ， 可 以 允许 浏览 者 上 传 图 片 、 上 传 压 缩 文件 等 。 除 此 之 外 ， 还 必须 对 浏览 
者 上 传 的 文件 大 小 进行 限制 。 因 此 必须 在 文件 上 传 中 进行 文件 过 滤 。 

这 一 节 将 为 读者 介绍 如 何 对 浏览 者 (用 户 ) 上 传 文件 进行 过 滤 ， 和 对 文件 上 传 进行 更 多 的 控制 。 
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9.3.1 基础 知识 一 一 对 文件 上 传 进行 更 多 的 控制 


对 于 控制 上 传 文件 的 大 小 、 格 式 ，Struts 2 提供 了 一 个 文件 上 传 的 拦截 器 
Interceptor 拦截 器 ， 通 过 配置 该 拦截 器 可 以 更 轻松 地 实现 文件 过 滤 。 

这 个 拦截 器 负责 处 理 文件 上 传 操 作 ， 它 是 默认 的 defaultStack 拦截 器 栈 的 一 员 。 即 使 你 对 
拦截 器 一 无 所 知 ， 也 可 以 轻松 完成 对 上 传 文件 的 管理 工作 。 不 过 ， 了 解 一 下 这 个 拦截 器 的 工作 
原理 可 以 更 好 地 在 Struts 2 应 用 程序 里 使 用 文件 上 传 功能 。 

FileUploadInterceptor 拦截 器 有 两 个 重要 的 属性 是 开发 者 通常 用 到 的 。 通 过 设置 以 下 两 个 属 
性 ， 可 以 对 上 传 文件 的 长 度 和 允许 上 传 的 内 容 类 型 进行 限制 。 

@ maximumSize: 上 传 文件 的 最 大 长 度 ( 以 字 节 为 单位 )， 默 认 值 大 约 是 2MB。 

@ allowedTypes: 以 和 逗号 分 隔 的 内 容 类 型 的 列表 (例如 : texthtml)， 符 合 列表 中 的 类 型 的 

文件 ， 可 以 被 传 给 Action。 如 果 没有 指定 这 个 参数 ， 那 么 就 是 允许 任何 上 传 类 型 。 

下 面 的 动作 对 上 传 文件 的 最 大 长 度 和 内 容 类 型 做 出 了 限制 一 一 只 允许 用 户 上 传 长 度 大 于 
1 000 000 个 字 节 的 JPEG、GIF 和 PNG 文件 。 


FileUpload 


<action name="FileUpload" class="com.struts2.actions.FileUploadAction"> 
<interceptor-ref name="fileUpload"> 
<param name="maximumSize">1000000</param> 
<param name="allowedTypes"> 
image/gif, image/jpeg, image/png 
</param> 
</interceptor-ref> 
</action> 
fileUpload 拦截 器 的 maximumSize 参数 只 是 设 定 Action 能 接受 的 文件 的 最 大 长 度 (在 Action 
处 理 之 前 ， 文 件 已 经 上 传 到 服务 器 上 了 )， 而 不 是 对 上 传 文件 的 最 大 长 度 进行 限制 。 
如 果 要 对 上 传 文件 的 最 大 长 度 进行 限制 ， 可 以 通过 设置 struts.multipart.maxSize 属性 来 实 
现 ， 该 属性 将 直接 影响 Struts 2 框架 底层 使 用 的 commons-fileupload 组 件 对 文件 的 接受 处 理 。 
如 果 上 传 的 文件 长 度 大 于 struts.multipart.maxSize 属性 的 值 ， 那 么 底层 的 commons- 
fileupload 组 件 将 抛 出 org.apache.commons.fileupload.FileUploadBase$SizeLimit Exceeded 
Exception 异常 ， 上 传 文件 拦截 器 捕获 到 该 异常 后 ， 将 直接 把 该 异常 的 消息 设置 为 Action 级 别 
的 错误 消息 。 如 果 在 页 面 中 使 用 <actionerror> 标 签 ， 将 看 到 如 下 的 错误 。 
the request was rejected because its size(6249303) exceeds the configured 
maximum(2097152) 


编辑 struts.xml 文件 ， 添 加 struts.multipart.maxSize 属性 的 设置 ， 如 下 所 示 。 

<constant name="struts.multipart.maxSize" value="1000000"/> 

在 上 传 页 面 中 可 以 用 <s:actionerror/> 标 签 调用 ， 输 出 文件 过 滤 失 败 后 的 错误 提示 信息 。 

如 果 用 户 上 传 的 文件 尺寸 大 于 给 定 的 最 大 长 度 或 是 其 内 容 类 型 没 被 列 在 allowedTypes 参 
数 里 , 将 会 显示 一 条 出 错 消 息 。 与 文件 上 传 有 关 的 出 错 消息 已 经 在 struts-messages.properties 文 
件 里 预先 定义 好 ， 这 个 文件 被 打包 在 Struts 2 的 系统 JAR 文件 里 。 下 面 是 这 个 文件 的 部 分 内 容 。 
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struts.message.error.uploading=Error uploading:{0} 
struts.message.error.file.too.large=File too large:{0} "{1}" {2} 
struts.message.error.content .type.not.allowed=Content-Type not 
allowed: {0} "{1}" {2} 


其 中 

@ struts.messages.error.uploading: 文件 不 能 上 传 的 通用 错误 信息 。 

@ struts.messages.error.file.too.large: 上 传 的 文件 长 度 太 大 的 错误 信息 。 

@@ struts.messages.error.content.type.not.allowed: 当 上 传 的 文件 不 匹配 指定 的 内 容 类 型 时 

的 错误 信息 。 

如 果 需 要 覆盖 这 些 默 认 的 出 错 提示 信息 ， 就 需要 在 WEB-INF/classes/org/apache/struts2 子 
目录 下 创建 一 个 名 为 struts-messages.properties 的 文件 , 然后 使 用 同样 的 key 把 需要 覆盖 的 默认 
信息 蔡 换 为 自己 的 东西 。 


”如 果 创 建 了 一 个 新 的 struts-messages.properties 文件 ，Struts 2 将 不 再 使 用 它 自 带 的 
注意 同名 文件 。 因 此 ， 如 果 需 要 履 盖 一 条 信息 并 继续 使 用 其 他 默认 出 错 提示 信息 的 情 
况 下 ， 千 万 不 要 忘记 把 它们 复制 到 新 创建 的 属性 文件 中 去 。 


9.3.2 ”实例 描述 


做 开发 者 有 一 个 令 人 很 头痛 的 事 ， 那 就 是 当 你 把 程序 做 好 时 ， 客 户 又 要 求 修改 。 有 的 项 目 
是 改 了 数 遍 ， 以 至 于 看 到 那个 项 目 就 心烦 意 乱 。 上 次 给 客户 做 的 OA 系统 中 的 上 传 文档 功能 ， 
客户 都 运行 了 几 天 了 ， 结 果 又 说 不 行 。 问 其 原因 是 他 们 公司 有 人 捣 鬼 ， 把 非常 大 的 文件 上 传 上 
去 了 ， 结 果 导 致 服务 器 崩溃 。 当 时 他 不 用 限制 上 传 文件 ， 很 大 的 、 多 种 格式 的 都 能 上 传 ， 遇 到 
麻烦 后 ， 才 要 求 修改 项 目 。 

这 次 ， 客 户 的 需求 是 : 只 能 上 传 图 片 ， 大 小 在 1000 字 节 以 内 。 


9.3.3 ”实例 应 用 


【 例 9-2】 控制 OA 系统 中 上 传 文档 大 小 和 格式 。 
(1) 在 上 一 节 的 案例 (OA 系统 “前 台 ” 上 传 文档 ) 基 础 上 ， 修 改 fleupload.xml 文件 ， 为 上 
传 文件 的 Action 类 (FileUploadAction 类 ) 配 置 FileUploadInterceptor 拦截 器 ， 配 置 它 的 
maximumSize 值 为 1000、allowedTypes 值 为 image 类型。 配置 代码 如 下 。 


<action name="upload" class="com.struts2.actions.FileUploadAction"> 

<interceptor-ref name="fileUpload"> 

<param name="maximumSize">10000</param> 

<param name="allowedTypes"> 

image/gif,image/jpeg, image/png 

</param> 
</interceptor-ref> 
<!-- 为 FileUploadAction 配置 defaultstack 拦截 器 引用 --> 


< 


二 人 Web 开发 学 习 实录 … 皇 


<interceptor-ref name="defaultstack"/> 

<!-- 配 置 文件 过 滤 失 败 后 要 跳 转 的 页 面 --> 

<result name="input">/fileupload.jsp</result> 

<result name="success">/success.jsp</result> 

<param name="uploadDir">/WEB-INF/UploadFiles</param> 
</action> 


》 在 配置 上 传 文件 Action 时 除了 必须 为 Action 配置 名 称 为 input 的 逻辑 视图 ， 还 必 
| 。 须 显示 地 为 该 Action 配置 拦截 器 引用 。 


(2) 在 本 项 目的 src 下 新 建 org.apache.struts2 包 , 并 在 这 个 包 下 创建 struts-messages.properties 
文件 ， 修 改 上 传 过 滤 失 败 后 的 提示 错误 信息 内 容 。struts-messages.properties 的 内 容 如 下 。 

# 改 变 文件 类 型 不 允许 的 提示 信息 

struts.messages.error.content.type.not. allowed= 您 上 传 的 文件 类 型 只 能 是 图 片 文件 ! 请 

重新 选择 ! 


# 改 变 上 传 文件 太 大 的 提示 信息 
struts.messages.error.file.too. large= 您 要 上 传 的 文件 太 大 ， 请 重新 选择 ! 


(3) 修改 fileupload.jsp 页 面 内 容 ， 输 出 错误 提示 信息 ， 代 码 如 下 。 
<!-- 使 用 红色 的 前 景色 输出 错误 信息 --> 


<div style="color:red"> 
<s:fielderror/> 
</div> 


(4) 在 fleupload.xml 文件 中 添加 下 面 代码 限 制 上 传 文件 的 最 大 长 度 。 


<constant name="struts.multipart.maxSize" value="1000000"/> 


注意 


图 9-6 ”上传 图 片 过 滤 失 败 提示 错误 信息 


sD >> 
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9.3.5 ”实例 分 析 


ee 


上 例子 中 ,在 项 目下 新 创建 的 org.apache.struts2 包 下 创建 了 struts-messages.properties 文件 。 
这 样 ， 在 运行 项 目 时 ，Struts 2 将 不 会 再 使 用 它 自 带 的 同名 的 文件 ， 因 此 当 文件 过 滤 失 败 后 ， 
会 读 取 自 己 新 创建 的 struts-message.properties 文件 中 的 内 容 ， 提 示 错 误 信息 。 


9.4 同时 上 传 多 个 文件 


同时 上 传 多 个 文件 在 Web 开发 中 也 是 必 不 可 少 的 功能 。 在 Struts 2 中 实现 多 文件 上 传 也 不 
是 很 难 ， 可 以 将 多 个 <s:file .…./> 绑 定 到 Action 的 File 数组 或 File 列表 中 。 
下 面 将 介绍 一 下 如 何 实现 同时 上 传 多 个 文件 。 


9 
?视频 教学 ， 光盘 /videos/09/upmanyfilel.avi 各 长度: 7 分 名 
光盘 /videos/09/ upmanyfile2.avi 全 长 度 : 6 分 钟 


9.4.1 基础 知识 一 一 同时 上 传 多 个 文件 


在 前 面 讲 到 上 传 文件 的 动作 类 中 必须 有 三 个 属性 ， 这 三 个 属性 的 名 字 必 须 是 以 下 格式 。 


[inputName]File 
[inputName]FileName 
[inputName]ContentType 


这 里 的 “[inputName] ”是 JSP 页 面 上 的 file 标签 的 名 字 。 如 果 是 上 传单 个 文件 ， 
[inputName]File 属性 的 类 型 就 是 java.io.File， 它 代表 被 上 传 的 文件 ，[inputName]FileName 属 
性 和 [inputName]ContentType 属性 的 类 型 是 String， 它 们 分 别 代 表 被 上 传 文件 的 文件 名 和 内 容 

如 果 上 传 多 个 文件 ， 可 以 使 用 数组 或 java.uitl.List。 例 如 ， 下 面 的 属性 分 别 是 File 数组 和 
String 数组 。 

private File[] image; 

private String[] imageFileName; 

private String[] imageContentType; 


如 果 使 用 List， 就 必须 把 这 三 个 属性 都 赋值 为 一 个 空白 的 列表 。 


Private List<File> image=new ArrayList<File>(); 
private List<String> imageFileName=new ArrayList<string>(); 


private List<String> imageContentType=new ArrayList<string>(); 


然后 循环 遍历 image 数组 或 者 集合 实现 单个 文件 上 传 。 


< 
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9.4.2 ”实例 描述 


前 几 天 ， 一 个 朋友 对 我 说 ， 他 的 项 目 经 理 要 求 他 给 一 个 客户 做 政府 部 门 的 系统 ， 其 中 有 一 
个 功能 的 实现 令 他 很 是 头痛 。 因 此 他 特意 咨询 我 。 

他 给 我 说 了 一 大 堆 有 关 这 个 难 住 他 的 功能 细节 后 ， 我 才 明白 ， 原 来 就 是 一 个 多 文件 上 传 ， 
让 他 没 略 了 。 大 概 给 他 说 了 一 下 多 文件 上 传 的 功能 思路 后 ， 他 忱 然 大 悟 。 

下 面 的 案例 就 实现 了 多 文件 上 传 功能 ， 希 望 读 者 不 要 像 我 朋友 那样 遇 到 棘手 的 问题 没 


9.4.3 ”实例 应 用 


【 例 9-3】 实现 多 文件 上 传 功能 。 

(1) 编辑 多 文件 上 传 的 动作 类 一 一 MultiFileUploadActionjava， 在 其 内 部 定义 三 个 数组 变 
量 , 分 别 代 表 多 个 上 传 文件 、 多 个 上 传 文件 的 文件 名 和 多 个 上 传 文件 的 MIME 类 型 。 重 写 父 类 
的 execute0 方 法 ， 循 环 遍历 多 个 文件 ， 实 现 多 文件 上 传 功 能 。 内 容 如 下 。 


package com.struts2.actions; 
import java.io.BufferedIinputstream; 
import java.io.BufferedOoutputstream; 
import java.io.File; 
import java.io.FileInputstream; 
import java.io.FileOutputSstream; 
import java.io.IOException; 
import java.util.Date; 
import org.apache.struts2.ServletActionContext; 
import com.opensymphony .xwork2.ActionSupport; 
/*# 
* 文件 上 传 Action 类 
* Qauthor Administrator 
和 
*/ 
public class MultiFileUploadAction extends Actionsupport { 
// 使 用 File 对 象 数组 ， 接 收 多 个 上 传 文件 
private Eile[] file; 
// 使 用 数组 保存 多 个 上 传 文件 的 文件 名 
private String[] fileFileName; 
// 使 用 数组 保存 多 个 上 传 文件 的 MTIME 类 型 
private String[] fileContentType; 
// 上 传 文件 的 描述 信息 
private String description; 
// 保 存 上 传 文件 的 目录 ， 相 对 于 Web 应 用 程序 的 根 路 径 ， 在 struts .xml 文件 中 配置 
private String uploadDir7 
override 
public String execute () throws Exception { 
String newFileName=null; 
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// 循 环 处 理 多 个 上 传 文件 
for (int i=0;i<file.length;i++){ 
// 得 到 当前 时 间 自 1990 年 1 月 1 日 0 时 0 分 0 秒 开始 流逝 的 毫秒 数 ,将 这 个 毫秒 数 作 
为 上 传 文件 的 新 文件 名 
long now=new Date () -getTime () 7 
// 得 到 保存 上 传 文件 的 目录 的 真实 路 径 
String 
path=ServletActionContext .getServletContext () .getRealPath (uploadDir); 
File dir=new File(path); 
// 如 果 这 个 目录 不 存在 ， 则 创建 它 
if(!dir.exists()){ 
dir.mkdir(); 
} 
int index=fileFileName[i].lastIindexOf('.'); 
// 判 断 上 传 文件 名 是 否 有 扩展 名 ， 以 时 间 截 取 为 新 的 文件 名 
if (index!=-1){ 
newFileName=now+fileFileName[i] .substring (index); 
}elsef{f 
newFileName=Long.toString (now); 


BufferedOutputStream bos=null; 

BufferedInputStream bis=nul17 

// 读 取保 存在 临时 目录 下 的 上 传 文件 ， 写 入 新 的 文件 中 

tryt{ 
FileInputStream fis=new FileInputStream(file[i]); 
bis=new BufferedIinputSstream(fis); 


FileoutputStream fos=new FileOutputstream(new 
Filel(dir,newFileName)); 
bos=new BufferedOutputstream(fos); 


byte[] buf=new byte[4096]; 


int len=-1; 

while( (len=bis.read(buf))!=-1){ 
bos.write (buf,0,1en); 

} 

}finallyt{ 

try{ 

if(null!=bis){ 
bis.close(); 

上 

} catch (IOException ex){ 
ex.printstackTrace () 7 


tryt{ 
if(null!=bos){ 
bos.close(); 
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}catch (IOException ex){ 
ex.printSstackTrace (); 


} 


return SUCCESS; 
} 
/* 下 面 是 上 面 所 有 属性 的 set 、get 方法 ， 这 里 省 略 */ 


实现 多 文件 上 传 可 以 使 用 上 面 所 用 的 数组 之 外 , 还 可 以 用 java.util.Lst, 至 于 用 List 
实现 ， 这 里 不 再 详 述 ， 因 为 它 和 上 面 使 用 数组 实现 多 文件 上 传 的 Action 代码 几乎 
相同 ,只 是 使 用 List<File> 代 替 了 上 面 的 File[], 并 使 用 List<String> 代 替 了 String[]， 
也 就 是 说 基本 上 是 一 样 的 ， 读 者 可 以 试 着 用 java.util.List 来 实现 多 文件 上 传 功能 。 


(2) 在 struts-config 文件 夹 下 新 建 multifileupload.xml 文件 ,配置 MultiFileUploadAction 类 。 
完整 内 容 如 下 。 

<?xml Version="1.0"” encoding="UTF-8" ?> 

<!-- 指定 拦截 器 的 DTD 信息 --> 

<!DOCTYPE struts PUBLIC 


"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 


[可 
站 


<struts> 
<package name="multiupload" namespace="/multiupload" 
extends="fileupload"> 
<action name="multiupload" 
class="com.struts2.actions.MultiFileUploadAction"> 
<result name="input">/multifileupload.jsp</result> 
<result name="success">/success.jsp</result> 
<!-- 动 态 配 置 uploadDir 属性 的 值 --> 
<param name="uploadDir">/WEB-INF/UploadFiles</param> 
</action> 
</package> 
</struts> 


(3) 把 刚 创 建 的 multifileupload.xml 文件 引入 struts.xml 文件 。 
(4) 在 WebRoot 下 新 建 multifileupload.jsp 页 面 ， 代 码 如 下 。 


<%@ page language="java" import="java.util.*" pageEncoding="gbk"g> 
<%Q@taglib prefix="s" uri="/struts-tags" %> 
< 
String path = request .getContextPath () 7 
String basePath = request.getscheme() + "://" 
+ request .getServerName () + ":" + request-getServerPort () 


0 1 
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%> 
<base href="<$%$=basePathgs>"> 
<s:form action="multiupload/multiupload.action" method="post" 
enctype="multipart/form-data"> 

<s:file name="file” label=" 请 选择 上 传 的 文件 一 "/> 

<s:file name="file" label=" 请 选择 上 传 的 文件 二 "/> 

<s:file name="file” label=" 请 选择 上 传 的 文件 三 "/> 

<s:submit value=" 上 传 " align="center" cssClass="button"/> 
</s:form> 


(5) 继续 在 WebRoot 下 新 建 上 传 文件 成 功 页 面 success.jsp。 


9.4.4 运行 结果 


运行 multifileupload.jsp 页 面 ， 出 现 如 图 9-7 所 示 的 界面 。 


多 文件 上 传 


9-7 ”多 文件 上 传 界面 


9.4.5 ”实例 分 析 


Ce 


上 例子 中 , 通过 查看 Action 代码 , 可 以 发 现 通过 数组 来 实现 上 传 多 个 文件 不 会 比 上 传单 个 
文件 复杂 多 少 ， 只 需要 提供 三 个 数组 属性 分 别 封装 多 个 上 传 文件 的 文件 名 、 文 件 类 型 和 文件 内 
容 即 可 。 在 处 理 文件 上 传 的 execute() 方 法 种 ， 只 需要 遍历 每 个 需要 上 传 的 文件 ， 并 将 每 个 文件 
逐次 写 入 服务 器 即 可 。Struts 2 系统 负责 将 三 个 文件 域 对 应 的 文件 内 容 、 文 件 名 和 文件 类 型 ， 
对 应 放 入 Action 实例 中 的 文件 内 容 数 组 .文件 名 和 文件 类 型 数组 中 一 一 这 个 过 程 无 需 开 发 者 关 
心 ， 这 个 过 程 也 有 力 地 证 明了 Struts 2 框架 的 简单 易 用 。 


< 
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9.5 文件 下 载 


Stmuts 2 提供 了 stream 结果 类 型 , 该 结果 类 型 是 专门 用 于 支持 文件 下 载 功能 的 。 指定 stream 
结果 类 型 时 ， 需 要 指定 一 个 inputName 参数 ， 该 参数 指定 了 一 个 输入 流 ， 这 个 输入 流 是 被 下 载 


文件 的 入 口 。 
通过 Struts 2 的 文件 下 载 支持 ， 允 许 系统 控制 浏览 者 下 载 文件 的 权限 ， 包 括 实现 文件 名 为 
非 西 欧 字符 的 文件 下 载 。 


下 面 将 介绍 一 下 在 Stmts 2 中 的 文件 下 载 功能 的 实现 。 
ca 视频 教学 : 光盘 /videos/09/filedown.avi 侠 长 度 : 6 分 钟 


9.5.1 基础 知识 一 一 Struts 2 对 文件 下 载 的 支持 


可 能 很 多 读者 会 认为 ， 文 件 下 载 很 简单 ， 直 接 在 页 面 上 给 出 一 个 超 链接 ， 该 链接 的 href 
属性 等 于 要 下 载 文件 的 文件 名 , 不 就 可 以 实现 文件 下 载 了 吗 ? 大 多 数 时 候 用 这 种 方式 可 以 实现 
文件 下 载 ， 但 如 果 该 文件 的 文件 名 为 中 文 文件 名 ， 则 会 导致 下 载 失 败 ， 应 用 程序 需要 在 用 户 下 
载 之 前 进行 进一步 检查 ， 比 如 判断 用 户 是 否 有 足够 权限 来 下 载 该 文件 等 ， 并 且 通 过 超 链接 下 载 
文件 ， 会 暴露 下 载 文件 的 真实 地 址 ， 不 利于 对 资源 进行 安全 保护 ， 而 且 利用 超 链接 下 载 文件 ， 
服务 器 端的 文件 只 能 存放 在 Web 应 用 程序 所 在 的 目录 下 。 

利用 程序 编码 实现 文件 下 载 ， 可 以 增加 安全 访问 控制 ， 对 经 过 授权 认证 的 用 户 提 供 下 载 ; 
还 可 以 从 任意 位 置 提供 下 载 的 数据 ， 可 以 将 文件 放 到 Web 应 用 程序 以 外 的 目录 中 ， 也 可 以 将 
文件 保存 到 数据 库 中 。 

利用 程序 实现 文件 下 载 非 常 简单 ， 只 需要 按照 如 下 的 方式 设置 三 个 报头 域 就 可 以 了 。 

Content-Type:application/x-msdownload 


Content-Disposition:attachment;filename=downloadfile 
Content-Length:filesize 


浏览 器 再 接收 到 上 述 的 报头 信息 后 ， 就 会 弹出 “文件 下 载 ” 对 话 框 ， 询 问 用 户 是 否 将 文件 
保存 到 本 地 硬盘 。 

1. Struts 2 对 文件 下 载 的 支持 

Struts 2 通过 org.apache.struts2.dispatcher.StreamResult 结果 类 型 来 支持 文件 下 载 , 使 得 原来 


编写 就 简单 的 下 载 程序 变 得 更 加 简单 了 。StreamResult 结果 类 型 利用 HttpServletResponse 对 象 
返回 的 ServletOutputStream 对 象 向 客户 端 输出 下 载 文件 的 二 进 制 数据 ， 它 有 下 列 参数 。 


contentType 
发 送 给 Web 浏览 器 的 数据 流 的 MIME 类 型 (默认 是 text/plain)， 即 下 载 文 件 的 内 容 类 型 。 
contentLength 
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数据 流 的 长 度 ， 以 字 节 为 单位 (浏览 器 显示 一 个 进度 栏 )， 即 下 载 文件 的 长 度 。 


contentDispostion 


用 于 控制 文件 下 载 的 一 些 信息 ， 可 选 的 设置 包括 : inline、filename=“ 下 载 文件 名 ”和 
attachment。 其 中 ，flename=“ 下 载 文件 名 ”中 ，filename 指定 下 载 的 文件 名 ; inline 表示 下 载 文 
件 在 本 页 面 内 部 打开 ; attachment 表示 弹出 “文件 下 载 ” 对 话 框 。 不 过 ， 这 也 不 是 绝对 的 ， 对 
于 浏览 器 能 够 显示 的 下 载 文件 是 这 样 的 ， 但 是 对 于 浏览 器 不 支持 的 下 载 类 型 ， 即 使 使 用 inline 
选项 ， 仍 然 会 弹出 “文件 下 载 ” 对 话 框 。contentDispostion 的 默认 值 是 inline。 


inputName 


Action 中 用 来 下 载 文件 的 属性 的 名 字 ， 该 属性 的 类 型 是 InputSteam。 默 认 值 是 inputStream。 


bufferSize 
文件 数据 从 输入 复制 到 输出 的 缓冲 区 的 大 小 ， 默 认为 1024 字 节 。 
2. 配置 文件 下 载 Action 


配置 文件 下 载 的 Action 与 配置 普通 的 Action 并 没有 太 大 的 不 同 , 需要 在 配置 普通 的 Action 
的 基础 之 上 ， 再 加 上 额外 的 download 的 拦截 器 引用 。 除 此 之 外 ， 关 键 是 需要 配置 一 个 类 型 为 
stream 的 结果 ， 配 置 时 需要 指定 如 下 四 个 属性 。 

@ contentType: 指定 被 下 载 文件 的 文件 类 型 。 

@ inputName: 指定 被 下 载 文件 的 入 口 输入 流 。 

@ contentDisposition: 指定 下 载 的 文件 名 。 

@ bufferSize: 指定 下 载 文件 时 的 缓冲 大 小 。 

因为 stream 结果 类 型 的 逻辑 视图 是 返回 给 客户 端 一 个 输入 流 , 因此 无 需 指 定 location 属性 。 


配置 stream 类 型 的 结果 时 ， 无 需 指 定 实际 显示 的 物理 资源 ， 也 无 需 指定 location 
给 示 | 属性 ， 只 需要 指定 inputName 属性 即 可 ， 该 属性 指向 被 下 载 文 件 。 
下 面 是 配置 该 下 载 所 用 的 Action 类 的 配置 文件 。 


<result name="success" type="stream"> 
<!-- 指定 下 载 文件 的 内 容 类 型 --> 
<param name="contentType">image/jpg</param> 
<!-- 指定 下 载 文件 的 文件 位 置 ， 它 的 默认 值 是 inputstream， 如 果 在 Action 

中 用 于 读 取 下 载 文件 内 容 的 属性 名 是 inputName， 那 么 这 里 可 以 省 略 这 个 参数 的 配置 --> 
<param name="inputName">targetFile</param> 
<param name="contentDisposition"> 
filename=tree.jpg 
</param> 
<!-- 指定 下 载 文件 的 缓冲 大 小 --> 
<param name="bufferSize">4096</param> 
</reanTt> 


如 果 通 过 上 面 的 Struts 2 提供 文件 下 载 支持 来 实现 文件 下 载 ， 就 可 以 实现 包含 中 文 文件 名 
的 文件 下 载 了 。 
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作 ， 


95 


提供 
如 下 


.2 ”实例 描述 


- 般 情 况 下 ， 有 文件 上 传 的 存在 就 有 文件 下 载 的 存在 。 上 次 给 客户 做 的 OA 系统 ， 也 存在 
文件 下 载 功能 。 当 用 户 把 上 传 的 文件 提交 给 上 级 领导 后 , 领导 可 以 下 载 相应 的 图 片 进行 查看 操 


以 供 审核 。 
以 下 的 实例 为 读者 展示 文件 下 载 功能 的 实现 。 


.3 实例 应 用 


【 例 9-4】 OA 系统 的 文件 下 载 功能 。 


(1) Stmts 2 的 文件 下 载 Action 与 普通 的 Action 并 没有 太 大 的 不 同 , 仅仅 是 该 Action 需要 
-个 返回 InputStream 流 的 方法 ， 该 输入 流 代表 了 被 下 载 文件 的 入 口 。 该 Action 类 的 代码 


o 


package com.struts2.actions; 
import java.io.Inputstream; 
import org.apache.struts2.ServletActionContext; 
import com.opensymphony .xwork2.ActionSupport; 
public class FileDownloadAction extends Actionsupport { 
private String inputPath;// 下 载 文件 的 路 径 ， 在 struts .xml 文件 中 配置 
/*# 
* 下 载 用 的 Action 应 该 返回 一 个 Inputstream 实例 
* 给 方法 对 应 在 result 里 的 inputName 属性 值 为 targetFile 
* @return 
i 
public InputStream getTargetFile() throws Exception{ 
return 
ServletActionContext .getServletContext () .getResourceAsStream (inputPath); 
} 
/*# 
* 依赖 注入 该 属性 值 的 setter 方法 
* @param inputPath 
public void setInputPath (String inputPath) { 
this.inputPath = inputPath; 
} 
妇女 
* 处 理 用 户 请 求 的 execute () 方法 ， 该 方法 返回 success 字符 串 
SR 
public String execute () throws Exception { 
return SUCCESS; 
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从 上 面 的 Action 中 看 出 ， 该 Action 中 包含 了 一 个 getTargetFile0 方 法 ， 该 方法 返回 一 个 
InputStream 输入 流 ， 这 个 输入 流 返回 的 是 下 载 目 标 文件 的 入 口 。 该 方法 的 方法 名 为 
getTargetFile， 表 明 该 Action 有 一 个 targetFile 属性 类 返回 下 载 文件 。 

(2) 在 struts-config 文件 夹 下 新 建 filedownload.xml 文件 ， 配 置 文件 下 载 Action 类 一 一 
FileDownloadAction 类 ， 配 置 如 下 。 


<struts> 
<package name="filedownload" namespace="/filedownload" 
extends="fileupload"> 
<action name="filedownload" 
class="com.struts2.actions.FileDownloadAction"> 
<!-- 指定 下 载 文件 的 路 径 ， 该 路 径 相对 于 Web 应 用 程序 所 在 的 目录 --> 
<param 
name="inputPath">/WEB-INF/UploadFiles/1288346027796.jpg</param> 
<!-- 使 用 streamResult 结果 类 型 --> 
<result name="success" type="stream"> 
<!-- 指定 下 载 文件 的 内 容 类 型 --> 
<param name="contentType">image/jpg</param> 
<!-- 指定 下 载 文件 的 文件 位 置 ， 它 的 默认 值 是 inputstream， 如 果 在 Action 
中 用 于 读 取 下 载 文件 内 容 的 属性 名 是 inputName， 那 么 这 里 可 以 省 略 这 个 参数 的 配置 --> 
<param name="inputName">targetFile</param> 
<param name="contentDisposition"> 
filename=tree.jpg 
</param> 
<!-- 指定 下 载 文件 的 缓冲 大 小 --> 
<param name="bufferSize">4096</param> 
</result> 
</action> 
</package> 
</struts> 


(3) 把 fledownload.xml 文件 引入 struts.xml 文件 中 。 
(4) 创建 人 edownload.jjsp 页 面 ， 即 下 载 文件 页 面 ， 代 码 如 下 。 


<%Q@taglib prefix="s" Uri="/struts-tags"g%> 
<s:a href="filedownload/filedownload.action"> 下 载 图 片 </s:a> 


9.5.4 ”运行 结果 


运行 人 ledownload.jsp 页 面 ， 出 现 如 图 9-8 所 示 的 界面 。 
单 击 “ 下 载 图 片 ” 超 链接 ， 出 现 如 图 9-9 所 示 的 界面 。 


< 


图 9-8 文件 下 载 界面 图 9-9 下 载 图 片 


9.5.5 ”实例 分 析 


Se 


上 个 例子 只 是 模拟 了 文件 下 载 功能 的 实现 ， 这 里 要 下 载 的 图 片 是 固定 的 (图 片 路 径 是 
/WEB-INF/UploadFiles/1288346027796.jpg), 在 实际 开发 中 图 片 不 可 能 是 固定 不 变 的 ， 一 般 是 动 
态 加载 的 ， 因 此 可 以 在 文件 下 载 Action 中 获取 数据 库 中 要 下 载 的 文件 并 赋 给 inputPath 属性 。 

contentDisposition 属性 默认 的 是 inline， 表 示 下 载 的 文件 内 容 在 本 页 面 中 打开 ， 因 此 ， 
当 单 击 “ 下 载 图 片 ” 超 链接 时 会 把 要 下 载 的 图 片 一 一 WEB/INF 下 的 UploadFiles 文件 夹 下 的 
1288346027796.jpg 内 容 在 下 载 文件 页 面 中 打开 ， 即 图 9-9 的 效果 。 


9.6 ”常见 问题 解答 


9.6.1 Struts 2 上 传 文件 大 小 问题 


Struts 2 上 传 文件 大 小 问题 ! 
网 络 课堂 : http://bbs.itzen.com/thread-10923-1-1.html 


最 近 在 学 习 Struts 2 中 的 文件 上 传 功能 时 ， 遇 到 一 个 棘手 的 问题 。 让 我 感到 不 解 的 是 有 时 
候 上 传 文件 不 会 出 现 错误 ， 有 时 候 却 会 错误 ， 好 像 有 人 在 捣 鬼 似 的 。 这 个 异常 就 是 
org.apache.commons.fileupload.FileUploadBase$SizeLimitExceededException。 

从 异常 来 看 ， 好 像 与 文件 大 小 有 关 ， 于 是 看 拦截 器 FileUploadInterceptor.java 的 源 代码 还 
是 不 明白 是 怎么 回 事 ? 百度 、Google 了 许久 ， 还 是 没 找到 问题 的 根本 原因 。 

这 是 经 常 遇 到 的 一 个 问题 ， 由 于 common-fileupload 组 件 默认 最 大 支持 上 传 文件 的 大 小 为 
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2M， 所 以 在 上 传 图 片 的 时 候 ， 上 传 了 大 于 2M 的 图 片 时 ， 就 会 出 现 org.apache. 

commons.fileupload FileUploadBase$SizeLimitExceededException 异常 。 在 控制 台 上 并 没有 打印 

出 这 个 异常 ， 这 个 异常 的 发 生 导致 了 fileUpload 拦截 器 没有 机 会 执行 ， 所 以 在 上 传 2M 以 上 的 

图 片 时 ， 页 面具 是 一 内 而 过 ， 仍 然 停留 在 之 前 定义 的 input 页 面 ， 什 么 错误 提示 都 没有 。 
【解决 办 法 】: 就 是 在 struts.xml 配置 文件 的 struts 标签 中 添加 如 下 代码 。 


<constant name=”struts.multipart.maxSize” value=”10485760”/> 


这 样 就 限制 了 上 传 文件 的 大 小 ， 把 限制 上 传 文件 的 大 小 定义 的 大 一 些 ， 问 题 就 解决 了 。 
9.6.2 Struts 2 中 ， 上 传 文件 过 大 时 ，JSP 页 面 也 不 显示 错误 


Struts 2 中 ， 上 传 文件 过 大 时 ，JSP 页 面 也 不 显示 错误 ? 
网 络 课堂 : http://bbs.itzcn.comy/thread-10924-1-1.html 


在 Struts 2 中 ， 当 上 传 文件 过 大 时 ， 如 何 使 JSP 页 面 不 显示 错误 信息 ? 
【解决 办 法 】: 我 们 Struts 2 本 身 提 供 了 一 个 文件 上 传 的 拦截 器 ， 通 过 配置 该 拦截 器 可 以 
更 轻松 地 实现 文件 过 滤 。 只 需要 在 Action 中 配置 该 拦截 器 就 OK 了 。 当 文件 过 滤 失 败 后 , 会 
动 转向 input 逻辑 视图 ， 因 此 必须 为 该 Action 配置 名 为 input 的 逻辑 视图 ， 除 此 之 外 还 必须 为 
配置 defaultStack 的 拦截 器 的 引用 。 配 置 文件 如 下 。 
<action name="upload"” class="com.annlee.upload.UploadAction" > 
<!-- 配置 fileUpload 的 拦截 器 --> 
<interceptor-ref name="fileUpload"> 
<!-- 配置 允许 上 传 的 文件 类 型 --> 
<param name="allowedTypes">image/bmp, image/gif,image/jpg</param> 
<!-- 配置 允许 上 传 的 文件 大 小 --> 
<param name="maximumSize">2000000</param> 
</interceptor-ref> 
<interceptor-ref name="defaultStack"></interceptor-ref> 
<param name="savePath">/</param> 
<result>/common/succ.jsp</result> 
<result name="input">/cos fileupload/fileupload.jsp</result> 
</action> 


如 果 上 传 失 败 ， 系 统 会 返回 到 原来 的 页 面 ， 要 在 原来 的 页 面 上 加 上 以 下 错误 提示 代码 : 
<s:fielderror/> 这 样 ， 系 统 就 会 返回 错误 信息 给 用 户 ， 但 是 这 时 的 提示 是 Struts 2 自 带 的 提示 ， 非 
常 不 友好 ， 配 置 国际 化 资源 文件 的 以 下 两 项 ， 提 示 就 会 自动 替换 成 自 定义 的 Struts 2 的 提示 ， 
提示 的 关键 字 如 下 。 

struts.messages.error.content .type.not.allowed 

struts.messages.error.file.too.large 

此 外 ， 如 果 用 户 上 传 失败 的 原因 不 是 因为 以 上 两 项 的 原因 ， 还 有 一 个 错误 信息 ， 它 的 关键 
字 是 如 下 。 


struts.messages.error.uploading 


< 
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9.6.3 Struts 2 上 传 文件 后 保存 到 我 的 项 目 文件 夹 中 却 是 一 个 tmp 文 件 


Struts 2 上 传 文件 后 保存 到 我 的 项 目 文件 夹 中 却 是 一 个 tmp 文件 ， 怎 么 回 事 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10928-1-1.html 


问题 是 这 样 的 : 我 上 传 一 个 图 片 为 ajpg， 结 果 到 我 的 项 目 文件 夹 下 却 是 
upload 82eela9 121ed4e4067 8000 0000003.tmp， 找 不 到 我 的 ajpg 了 ， 这 是 什么 原因 ?难道 是 
代码 有 问题 吗 ? 下 面 是 我 的 Action 类 代码 片段 。 


private File myFile;// 实际 上 传 文件 
private String contentType;// 文件 的 内 容 类 型 
private String fileName;// 上 传 文件 名 
/* 这 里 是 上 面 三 个 属性 的 set、get 方法 ， 省 略 */ 
public void copyFile(File src, File target) { 
InputStream is = null; 
Outputstream os = null; 
byte[] number = new byte[BUFFER SIZE]; 
try { 


is = new BufferedInputStream (new FileInputstream(src), 
BUFFER SIZE); 

os = new BufferedOutputStream (new FileOutputstream(target), 

BUFFER_ SIZE); 

while (is.read(number) > 0) { 

os.write (number); 

} 

os.close(); 

is.close(); 

} catch (Exception ex) 


{ 


/* 省 略 */ 
} 
} 
/妇女 
* 上 传动 作 执行 
六 


public String loadPicture() 
{ 

/** 省 略 处 理 上 传 文件 的 操作 */ 
} 


【解决 办 法 】: 看 了 上 面 的 代码 ， 读 者 看 出 有 什么 不 妥 了 吗 ? 我 来 回答 一 下 以 上 发 生 的 错 
误 原因 所 在 。 

首先 在 Action 中 的 上 传动 作 方 法 中 编写 System.out.println(“ 文 件 名 字 ”+filename):; 代 码 ， 判 
断 是 否 获取 到 了 文件 名 (fileName 的 是 否 为 空 )。 

然后 根据 判断 ， 确 定 原因 : 如 果 变 量 fleName 为 空 ， 那 么 修改 变量 声明 为 如 下 所 示 。 
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private File myFile;// 实 际 上 传 文件 

private String myFileContentType;// 文 件 的 内 容 类 型 

private String myFileFileName;// 上 传 文件 名 

修改 的 原因 : Struts 2 上 传 文件 是 接收 到 前 台 的 参数 进行 后 台 给 变量 赋值 的 ， 变 量 的 名 称 
的 定义 不 是 随便 的 。 


9.6.4 Struts 2 上 传 中 文 文件 名 文件 下 载 后 编程 乱码 


Struts 2 上 传 中 文 文件 名 文件 下 载 后 编程 乱码 ， 怎 么 解决 啊 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10929-1-1.html 

【解决 办 法 】: 这 个 问题 经 常会 遇 到 。 其 实 方法 很 简单 ， 就 是 转 码 。 转 码 的 方式 有 很 多 ， 
经 常用 到 的 是 下 面 这 种 方式 。 

String fileName = "中 文 文件 名 ";// 取 得 原 中 文 文件 名 


fileName=new String (fileName.getBytes( "gb2312 ")，"iso-8859-1 ");// 处 理 中 文 
乱码 名 


一 、 填 空 题 

(1) Struts 2 默认 使 用 的 上 传 组 件 是 Apache 组 织 的 组 件 。 

(2) Stmts 2 提供 了 一 个 文件 上 传 拦截 器 : ， 它 负责 调用 底层 的 文件 上 传 组 件 
解析 文件 内 容 ， 并 为 Action 准备 与 上 传 文件 相关 的 属性 值 。 

(3) 下 面 代码 中 ， 如 果 对 只 能 上 传 图 片 进行 控制 ，“ ”处 应 填写 


<interceptor-ref name="fileUpload"> 
<param name="maximumSize">1000000</param> 
<param name="allowedTypes"> 


</param> 
</interceptor-ref> 


(4) 如 果 上 传 多 个 文件 ， 可 以 使 用 数组 或 


(5) StreamResult 结果 类 型 中 的 参数 表示 下 载 文件 的 名 字 。 

二 、 选 择 题 

(1) 不 是 表单 元 素 的 enctype 属性 有 3 个 值 ， 分 别 是 
A. application/x-www-form-urlencoded B. multipart/form-date 
C. multipart/form-data D. text/plain 


< 
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(2) 处 理 文件 上 传 请 求 的 Action 必须 提供 特殊 样式 命名 的 属性 , 例如 ,假设 表单 中 文件 选 
择 框 (<input type=“file”name=“tpload”>) 的 名 字 是 upload,， 那么 Action 应 该 提供 下 列 三 个 属性 。 
下 面 代码 中 哪 组 是 正确 的 

A. private File upload; 


private String uploadFileName; 
private String uploadContentType; 


B. private string upload; 
private String uploadFileName; 


private String uploadContentType; 


C. private String upload; 
private File uploadFileName; 
private String uploadContentType; 


D. private File upload; 
private String filename; 
private String contentType; 


(3) FileUploadInterceptor 拦截 器 有 两 个 重要 的 属性 可 以 对 上 传 文件 的 长 度 和 允许 上 传 的 
内 容 类 型 进行 限制 ， 这 两 个 属性 是 
A. maximumSize 和 allowedTypes B. maxLength 和 Types 
C. max 和 allowedTypes D. maximumSize 和 Types 
(4) 如 果 你 想 履 盖 Stmts 2 内 部 提供 的 上 传 失败 错误 信息 ， 就 需要 在 
WEB-INF/classes/org/apache/struts2 子 目 录 下 创建 一 个 名 为 struts-messages.properties 的 文件 , 然 
后 使 用 同样 的 key 把 你 打算 履 盖 的 默认 消息 替换 为 你 自己 的 东西 。 下 面 哪些 是 在 
struts-messages.properties 中 不 出 现 的 ? 
A. struts.message.error.uploading 
B. strmts.message.error.file.too.large 
C. strmts.message.error.content.type.not.allowed 


D. strmts.message.error.allows 
三 、 上 机 练习 


上 机 练习 : 把 上 传 的 图 片 下 载 ， 并 显示 在 页 面 上 。 

要 求 : 

(1) 实现 多 文件 上 传 。 在 表单 中 设置 三 个 File 元 素 ， 同 时 上 传 3 张 图 片 ， 如 图 9-10 所 示 。 

(2) 单 击 “ 上 传 ”按钮 后 , 跳 转 至 上 传 成 功 页 面 , 并 把 上 传 的 图 片 显 示 在 页 面 上 , 如 图 9-11 
所 示 的 界面 。 
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9-11 文件 上 传 成 功 界面 


(3) 单 击 “图 片 ”， 实 现下 载 功 能 ， 并 在 本 页 面 中 显示 出 要 下 载 的 图 片 内 容 。 如 图 9-12 


所 示 。 


图 9-12 下 载 图 片 


< 
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页 面 


内 容 摘要 : 

当 用 户 在 表单 中 填写 完 自己 的 信息 内 容 之 后 ， 单 击 提交 按钮 后 ， 可 能 没有 看 到 自己 想 要 的 
运行 效果 进而 重复 单 击 提交 按钮 ， 从 而 导致 服务 器 接受 到 的 信息 是 用 户 单 击 次 数 的 条 数 信息 内 
容 , 或 者 是 注册 时 没有 发 现 注册 成 功 而 重复 单 击 导 致 数据 库 抛 出 异常 。 在 实际 应 用 中 同样 存在 ， 
由 于 用 户 没有 及 时 看 到 相应 的 信息 ， 导 致 重复 提交 的 事 时 有 发 生 。 

为 避免 表单 的 重复 提交 可 以 在 客户 端 通过 JavaScript 脚本 实现 ， 也 可 以 在 服务 器 端 实现 。 
本 章 介 绍 如 何 使 用 Struts 2 避免 表单 重复 提交 ， 和 检测 表单 是 否 重 复 提交 机 制 。 

学 习 目标 : 


防止 表单 重复 提交 的 机 制 。 

掌握 TokenIntercepter 拦截 器 的 使 用 。 

掌握 TokenSessionStoreInterceptor 拦截 器 使 用 。 

使 用 ExecuteAndWaitInterceptor 拦截 器 向 用 户 显示 等 待 页 面 。 
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10.1 避免 表单 重复 提交 


如 果 应 用 程序 没有 处 理 表单 的 重复 提交 现象 ， 用 户 提交 的 “注册 ”、 或 者 上 传 的 文件 等 ， 
将 会 被 发 送 两 次 或 者 多 次 ， 从 而 导致 在 数据 库 中 添加 多 条 记录 。 

如 何 避 免 这 种 情况 呢 ? 具体 实 现时 ， 可 以 在 客户 端 通过 JavaScripte 脚本 , 或 者 在 服务 器 端 
实现 。 例 如 ， 如 果 在 Action 中 进行 处 理 ， 读 者 很 容易 想到 利用 session， 在 用 户 单 击 提交 按钮 
时 ， 判 断 该 请 求 是 否 被 提交 过 。 


9 
是 视频 教学 ;光盘 /videos/10/tokenl.avi 全 长 度 :10 分钟 
光盘 /videos/10/token.avi 名 长 度 :10 分钟 
光盘 /videos/10/ tokenSession avi @@ 长 度 : 5 分 钟 


10.1.1 基础 知识 一 一 token 标 签 的 作用 


如 何在 生成 页 面 时 生成 token 字段 呢 ? Struts 2 框架 提供 了 token 标签 。 例 如 , 在 form 表单 
中 , 定义 <s:token /> 语句 , 这 样 就 在 页 面 文件 中 添加 token 标签 。 在 运行 程序 请 求 该 页 面 文件 时 ， 
在 运行 页 面 的 源 文件 中 ， 可 以 看 到 如 下 形式 的 代码 。 

<input type="hidden" name="struts.token" 

value="QAP2MPXRBP9SPRF2JVESUUHRDQ04Z51W" /> 


@ $ token 标签 根据 每 次 请 求 的 内 容 ， 将 生成 一 个 唯一 性 的 隐藏 字段 value 值 ， 字 段 长 
给 示 | 。 度 为 32 守节. 

token 标签 通过 这 个 隐藏 表单 域 ， 实 现在 服务 器 端 避免 表单 重复 提交 ， 其 实现 原理 如 下 。 

(1) 服务 器 端 在 处 理 客 户 端 请 求 时 , 创建 一 个 session 对 象 和 一 个 token 值 (命名 为 token1)， 
也 称 为 令 牌 值 。 然 后 将 tokenl 作为 隐藏 表单 域 的 值 ， 随 处 理 结果 一 起 发 送 到 客户 端 ， 同 时 将 
tokenl 保存 到 session 中 。 

(2) 服务 器 端 在 处 理 得 到 的 请 求 之 前 ， 将 请 求 中 的 tokenl 与 保存 在 当前 用 户 session 中 的 
值 进行 比较 ， 检 查 这 两 个 值 是 否 匹 配 。 

(3) 如 果 相等 ， 表 示 用 户 是 第 一 次 提交 该 表单 ， 则 清除 session 中 的 token1， 然 后 执行 数 
据 处 理 操作 ， 同 时 产生 一 个 新 的 token 值 (命名 为 token2)， 保 存 到 session 中 ， 当 用 户 重 新 访问 
提交 数据 页 面 时 ， 将 新 产生 的 token2 作为 隐藏 输入 域 的 值 。 

(4) 如果 用 户 退 回 到 刚才 的 提交 页 面 并 再 次 提交 ， 客 户 端 传 过 来 的 token 值 ， 是 token1， 
而 服务 器 端的 token 值 已 经 为 token2， 这 两 个 token 值 不 相等 ， 将 不 再 对 用 户 的 请 求 进行 提交 ， 
从 而 有 效 地 防止 了 重复 提交 的 发 生 。 

”token 标签 必须 与 TokenInterceptor、TokenSessionStoreInterceptor 或 者 ExecuteAnd 
8 未 | 。 WaitInterceptor 等 配合 使 用 ， 这 三 个 拦截 器 都 能 对 token 标签 进行 处 理 。 
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10.1.2 ”基础 知识 


使 用 Tokenlnterceptor 


在 本 节 中 ， 将 学 习 token 标签 和 token 拦截 器 的 应 用 和 实现 避免 表单 的 重复 提交 。token 标 
签 定义 在 JSP 页 面 文件 中 ，token 拦截 器 配置 在 struts.xml 文件 中 。 

在 此 使 用 org.apache.struts2.interceptor.TokenInterceptor.TokenInterceptor 拦截 器 防止 用 户 重 
复 提交 的 操作 。 当 表单 提交 时 , TokenIntorceptor 拦截 器 截取 请 求 , 获取 标准 的 struts.token.name 
请 求 ， 得 到 保存 令 牌 值 的 请 求 参数 名 ， 然 后 在 根据 这 个 请 求 参数 获取 令 牌 值 内 容 ， 再 根据 令 牌 
名 ， 从 session 中 取出 <s:token> 标 签 之 前 保存 到 session 中 的 令 牌 值 信息 ， 紧 接着 对 两 个 令 牌 值 
进行 比较 ， 如 果 session 中 的 令 牌 值 等 于 请 求 提交 的 令 牌 值 ， 那 么 就 删除 session 中 的 令 牌 值 ， 
并 且 调用 handleValidToken0 方 法 ， 该 方法 直接 调用 Action 的 方法 请 求 进行 处 理 。 如 果 两 个 值 
不 相等 , 那么 handleInvalidToken() 方 法 被 调用 。 首先 它 会 添加 一 个 Action 级 别 的 错误 消息 到 这 
个 Action 中 ， 然 后 返回 结果 编码 ， 从 而 跳 过 Action 的 执行 。 

TokenInterceptor 拦截 器 的 处 理 过 重 , 除了 需要 为 Acion 配置 这 个 拦截 器 的 引用 外 ,同时 还 
需要 配置 “invalid.token ”结果 映射 ， 以 便 拦 截 器 在 表单 重复 提交 时 , 将 请 求 转向 这 个 结果 视图 。 

<%@ page language="java" import="java.util.*" pageEncoding="GB2312"%> 

<%@ taglib prefix="s" uri="/struts-tags" $%> 


<h4> 用 户 登录 </h4> 

<s:form action="login"> 
<s:token/> // 使 用 token 标签 
<s:actionerror/> // 使 用 actionerror 标签 


<s:textfield name="userName"” label=" 姓 名 "/> 
<s:password name="userPassword" label=" 密 码 "/> 
<s:submit value=" 登 录 "/> 
</s:form> 
上 述 内 容 的 from 表单 中 ， 使 用 <s:token/> 语 句 添 加 token 标签 ， 使 用 actionerror 标签 输出 
错误 信息 。 


10.1.3 ”基础 知识 一 一 使 用 TokenSession Storelnterceptor 


对 表单 重复 提交 后 会 向 用 户 显示 一 条 错误 消息 ,在 此 需要 使 用 org.apache.struts2. interceptor. 
TokenSessionStoreInterceptor 拦截 器 。 

TokenSessionStoreInterceptor 继承 自 TokenInterceptor, 并 重 写 了 handleValidToken0 方 法 和 
handleInvalidToken() 方 法 ,handleValidToken0 〇 方法 在 session 中 保存 了 一 个 包含 ActionInvocation 
实例 和 令 牌 对 象 ， 如 果 重 复 提交 了 相同 的 对 象 ， 那 么 handleInvalidToken() 方 法 从 session 中 去 
除 这 个 对 象 ， 然 后 根据 保存 的 Action 的 状态 重新 输出 结果 页 面 ， 同 时 Action 不 会 重复 执行 。 
如 果 不 同 的 令 牌 或 者 令 牌 为 null， 那 么 handleInvalidToken0 方 法 则 返回 INVALID_TOKEN_ 
CODE 结果 信息 ， 那 么 请 求 转向 invalid.token 结果 码 映 射 的 视图 。 

tokenSession 拦截 器 扩展 了 token 拦截 器 , 但 是 tokenSession 拦截 器 不 会 返回 一 个 特殊 的 结 
果 ， 也 不 会 添加 一 个 动作 错误 ， 只 是 阻 断 后 面 的 提交 ， 这 样 做 的 结果 就 是 用 户 将 看 到 同样 的 响 


< 


Ai 人 Web 开发 学 习 实录 . 忆 


应 ， 就 好 像 只 有 一 次 提交 。 


一 tokenSession 拦截 器 的 实现 类 是 TokenSessionStoreInterceptor。 


技巧 
如 果 使 用 tokenSession 拦截 器 ,只 需要 在 前 面 的 登录 示例 中 , 修改 struts.xml 文件 中 的 代码 ， 
如 下 所 示 。 


<package name="default" extends="struts-default"> 
<action name="login" class="action.LoginAction"> 
<interceptor-ref name="defaultstack" /> 
<interceptor-ref name="tokenSession"/> // 配 置 tokenSession 拦截 器 
<result name="invalid.token">/login.jsp</result> 
<result name="success">/index.jsp</result> 
</action> 
<package> 


上 述 代码 中 ， 将 <interceptor-ref name="token"/> 修 改 为 <interceptor-ref name="token 
Session"/>， 表 示 使 用 tokenSession 拦截 器 。 


10.1.4 实例 描述 


通过 使 用 org.apache.struts2.interceptor.TokenInterceptor.TokenInterceptor 拦截 器 来 防止 用 户 
登录 重复 提交 的 操作 ， 当 用 户 重 复 单 击 登陆 时 进行 信息 提示 ， 同 时 只 向 服务 器 发 送 一 次 请 求 。 
当 用 户 单 击 登 录 时 系统 调用 后 台 处 理 代 码 ， 然 后 转向 至 首页 面 ， 当 用 户 重 复 提交 ， 系 统 将 给 出 
消息 提示 ， 或 者 用 户 单 击 后 退 再 次 登录 时 ， 都 会 转向 消息 提示 页 面 。 


10.1.5 实例 应 用 


【 例 10-1】 用 户 登 录 表 单 重复 提交 。 

(1) 首先 借助 于 第 四 章 第 6 节 的 登录 案例 进行 完成 。 首先 在 工程 目录 内 添加 一 个 登录 后 的 
首页 面 和 重复 登录 时 提示 消息 页 面 。 

(2) 接 下 来 创建 一 个 LoginFormAction.java 的 Action 用 来 处 理 登 录 请 求 ,返回 登录 后 的 首 
页 面 详细 代码 如 下 。 

<!-- 省 略 部 分 代码 --> 

public class LoginFormAction extends Actionsupport{ 


public String execute() 


return SUCCESS; 
} 
} 
<!-- 省 略 部 分 代码 --> 
上 述 代码 中 ,常见 的 Action 继承 与 ActionSupport 类 ,在 该 类 中 创建 一 个 默认 的 方法 execute() 
方法 用 来 处 理 登 录 请 求 然后 返回 SUCCESS 页 面 。 
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(3) 配置 struts.xml 中 的 LoginFormAction java 的 Action 配置 ， 设 置 SUCCESS 转向 页 面 ， 
详细 代码 如 下 所 示 。 


<!-- 省 略 部 分 代码 --> 
<action name="loginform" class="com.itzcn.action.LoginFormAction"> 
<interceptor-ref name="token"/> 
<interceptor-ref name="defaultstack" /> 
<result name="invalid.token">/error.jsp</result> 
<result name="success">/loginsuccess.jsp</result> 
</action> 


<!-- 省 略 部 分 代码 --> 


在 <action> 元 素 中 , 配置 默认 拦截 器 defaultStack, <interceptor-ref name="token"/> 配 置 token 
拦截 器 。 在 <result 人 > 元 素 中 ， 配 置 invalid.token 的 返回 结果 。 


人 》 由 于 拦截 器 按照 struts.xml 中 所 配置 的 顺序 依次 执行 , 为 了 更 早 的 结 来 重复 提交 的 
技巧 | ”处 理 ， 应 该 将 token 拦截 器 放 在 所 有 拦截 器 的 前 面 。 


(4) 最 后 登录 页 面 提交 表单 form 里 面 设置 token 的 标签 ， 详 细 代码 如 下 所 示 。 


<s:form action="loginform.action"> 
<s:token/> // 使 用 token 标签 
<s:textfield name="userName"” label=" 姓 名 "/> 
<s:password name="userPassword"” label=" 密 码 "/> 
<s:submit value=" 登 录 "/> 

</s:form> 


上 述 代码 中 ， 在 登录 页 面 form 提交 值 loginform.action 时 设置 拦截 器 使 用 token 标签 。 使 
用 <s:actionerror/> 标 签 输出 错误 信息 ， 该 标签 配置 在 errorjsp 错误 消息 提示 页 面 。 


10.1.6 ”运行 结果 


部 署 项 目 ， 启 动 Tomcat， 在 地 址 栏 里 面 输入 http://localhost:8080/ch10_1/login.action， 运 行 
结果 如 图 10-1 所 示 。 


-Eee 


友 闪 直 。 湖 用 户 昌 


10-1 登录 页 面 运行 结果 
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单 击 “登录 ”按钮 后 ， 页 面 将 会 提交 至 loginform.action 进行 处 理 转向 登录 后 的 首页 面 如 
图 10-2 所 示 ， 当 刷新 登录 后 的 首页 面 或 者 重复 提交 拦截 器 则 会 拦截 跳 转 至 消息 提示 页 面 如 
图 10-3， 同 时 提示 一 些 信息 内 容 。 


回回 加 


图 10-2 登录 成 功 首页 面 图 10-3 重复 登录 提示 消息 页 面 


10.1.7 ”实例 分 析 


en 


通过 使 用 TokenInterceptor 的 拦截 器 获取 用 户 请 求 判 断 ， 如 果 用 户 第 一 次 表单 提交 访问 
Action 则 执行 ， 如 果 表 单 第 二 次 或 者 重复 提交 则 转向 struts.xml 文件 中 配置 <result> 节 点 中 的 页 
面 内 。 因 此 可 以 通过 该 拦截 器 来 做 到 避免 表单 重复 提交 的 问题 ， 也 可 以 避免 用 户 在 某 些 操作 上 
出 现 的 问题 。 


10.2 ”设置 等 待 页 面 


有 时 候 在 处 理 某 些 操作 或 者 请 求 的 时 候 可 能 会 耗费 大 量 的 时 间 , 用 户 可 能 会 不 断 的 提交 或 
者 重复 的 刷新 页 面 , 这 种 情况 下 向 用 户 显示 一 个 等 待 的 页 面 比 采 用 防止 用 户 重复 提交 的 效果 会 
更 好 一 些 。 
Struts 2 也 考虑 到 了 这 一 点 , 它 提供 了 ExecuteAndWaitInterceptor 拦 截 器 在 用 户 提交 表单 后 ， 
向 用 户 显示 一 个 等 待 提交 页 面 的 提示 消息 ， 等 待 页 面 定时 向 服务 器 提交 请 求 ， 以 确定 服务 器 获 
取 的 请 求 是 否 完成 。 如 果 请 求 已 经 完成 ，ExecuteAndWaitInterceptor 拦截 器 将 把 请 求 转向 结果 
页 面 。 


s 
视频 教学 ， 光盘 /videos/10/execAndWait.avi 从 长 度 : 6 分 钟 
光盘 /videos/10/execAndWaitl.avi 长度 : 5 分钟 
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10.2.1 基础 知识 


ExecuteAndWaitInterceptor 拦截 器 (简称 : execAndWait) 能 够 在 用 户 请 求 提交 之 后 执行 一 个 
耗费 较 长 时 间 的 Action 在 后 台 执 行 ， 而 且 向 用 户 显示 一 个 执行 的 进度 信息 。 如 果 在 请 求 一 个 
Action 执行 的 时 间 超 过 10 分 钟 ， 它 可 以 防止 HTTP 请 求 超时 。 

当 用 户 提交 一 个 表单 请 求 时 ，ExecuteAndWaitInterceptor 拦截 器 将 会 创建 一 个 新 的 线程 来 
处 理 执行 的 Action， 同 时 向 用 户 显示 一 个 等 待 的 消息 内 容 ， 让 用 户 知道 请 求 处 理 的 内 容 正 在 执 
行 。 等 待 页 面 中 有 一 种 自动 刷新 的 功能 ， 可 以 不 断 地 通知 浏览 器 在 几 秒 钟 发送 一 次 请 求 ， 
ExecuteAndWaitInterceptor 拦截 器 自动 截取 请 求 内 容 判 断 该 请 求 是 否 被 执行 完毕 ， 同 时 返回 用 
户 当前 的 请 求 信息 ， 如 果 没 有 请 求 完 毕 则 通知 用 户 继续 等 待 ， 如 果 请 求 执行 完毕 则 转向 结果 
页 面 。 

ExecuteAndWaitInterceptor 是 基于 每 个 session 工作 的 , 也 就 是 说 同一 个 Action 不 可 以 在 同 

-个 session 中 运行 一 次 或 者 多 次 。ExecuteAndWaitInterceptor 拦截 器 自身 自 带 了 一 个 请 求 等 待 
的 页 面 ， 它 在 org/apache/struts2/interceptorwait fl。 这 个 等 待 页 面 非常 简单 ， 因 此 可 以 使 用 自 
己 编写 好 的 等 待 页 面 ， 为 Action 配置 wait 结果 映射 ， 转 向 编写 好 的 等 待 页 面 。 

ExecuteAndWaitInterceptor 拦截 器 已 经 在 struts-default.xml 文件 中 定义 ， 但 没有 包含 在 

defaultStack 拦截 器 栈 中 ， 因 此 需要 为 Action 配置 引用 这 个 拦截 器 。 


defaultStack 拦截 器 必须 配置 为 引用 拦截 器 中 的 最 后 一 个 ， 因 为 它 会 停止 后 续 的 所 

注意 有 操作 ， 在 它 之 后 的 拦截 器 都 不 会 被 再 次 调用 ，ExecuteAndWaitInterceptor 拦截 器 
创建 的 线程 只 会 运行 Action， 在 ExecuteAndWaitInterceptor 之 后 的 所 有 拦截 器 都 
不 会 被 调用 执行 。 

ExecuteAndWaitInterceptor 初始 化 等 待 时 间 可 以 在 服务 器 显示 等 待 页 面 之 前 延迟 一 定 的 时 
间 段 。 在 延迟 的 时 间 内 ，ExecuteAndWaitInterceptor 拦截 器 每 隔 100 毫秒 都 会 自动 检查 后 台 线 
程 是 否 执行 完毕 。 如 果 因 为 某 种 原因 该 任务 提前 完成 ， 那 么 等 待 页 面 就 不 会 显示 出 来 提示 用 户 
等 待 的 消息 内 容 。 相 反 如 果 由 于 某 种 原因 该 任务 需要 耗费 很 大 的 时 间 段 ， 则 会 显示 出 来 等 待 的 
消息 提示 页 面 。ExecuteAndWaitInterceptor 拦截 器 有 如 下 几 个 常用 的 属性 参数 。 

®@ threadPriority: 指定 线程 的 优先 级 别 ， 默 认 值 为 Thread.NORM_PRIORITY。 

@ ”delaySleepInterval: 该 参数 只 能 和 delay 参数 使 用 , 用 来 检查 执行 的 程序 是 否 执行 完毕 

的 间隔 时 间 。 默 认 值 为 100 毫秒 。 

@ delay: 显示 等 待 页 面 初 始 的 等 待 延迟 时 间 ， 默 认 是 没 等 待 延迟 。 
凡是 被 ExecuteAndWaitInterceptor 拦截 器 拦截 的 Action 将 会 单独 创建 一 个 Action 
来 执行 ， 因 此 这 个 Action 不 能 使 用 ActionContext， 因 为 ActionContext 是 线程 本 
地 的 。 比 如 说 访问 了 一 个 session 的 数据 那么 你 就 必须 实现 SessionAware 接口 而 不 
能 直接 调用 ActionContext.getSession() 方 法 。 


使 用 ExecuteAndWaitlnterceptor 


沸 
部 


10.2.2 ”实例 描述 


在 这 里 同样 使 用 登录 系统 来 实现 登录 时 转向 等 待 页 面 ， 这 次 使 用 ExecuteAndWait- 
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Interceptor 拦截 器 ， 在 用 户 单 各 
示 等 待 消息 。 


“登录 ”按钮 提交 登录 信息 后 ， 服 务 器 处 理 完毕 之 前 向 用 户 显 


ET 


10.2.3 ”实例 应 用 


【 例 10-2】 用 户 登 录 自 动 显 示 登 录 页 面 。 
(1) 在 资源 文件 中 添加 等 待 提示 消息 内 容 。 编 辑 com'itzcnaction 包 中 的 
LoginAction zh_CN.properties 文件 ， 添 加 等 待 提示 消息 ， 代 码 如 下 所 示 。 


global .wait= 您 的 请 求 正在 处 理 ， 请 稍 后 。<br/> 如 果 页 面 没有 自动 重新 加 载 ， 请 <a href="{0}"> 
单 击 这 里 </a> 


(2) 由 于 不 希望 使 用 到 自 带 的 等 待 页 面 , 因此 需要 编写 一 个 自己 的 等 待 页 面 , 在 WebRoot\ 
WEB-INF\freemarker 目录 下 创建 一 个 wait.html 文件 ， 代 码 如 下 所 示 。 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 
1.0 Transitional//EN" 
"http://www.w3.0org/TR/xhtmll1/DTD/xhtmll-transitional.dtd"> 
<html> 
<head> 
<title>Please wait</title> 
<@s.url includeParams="all" id="url"/> 
<meta http-equiv="refresh" content=5;url=${url}> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" 
/><style type="text/css"> 
<¥Y== 
body,td,th { 
font-size: 12px; 
text-align: center; 


: 


--> 
</style></head> 
<body> 
<p><img src="images/20080318173010854.gif" /></p> 
<p><@s.text name="global .wait"> 
<@s.param value="#url"/> 
</@s.text></p> 
</body> 
</html> 


在 上 述 代 码 中 , 需要 注意 <@s.url> 标 签 的 includeParams 属性 必须 使 用 , 因为 当 等 待 页 面 刷 
新 时 ， 浏 览 器 将 会 重新 发 送 一 次 登录 请 求 到 Action， 如 果 没有 用 户 登录 消息 ， 那 么 发 送 请 求 时 
将 会 出 现 空 异常 。 

(3) 编写 struts.xml 文件 ， 为 register action 配置 引用 ExecuteAndWaitInterceptor 拦截 器 ， 
同时 配置 wait 结果 映射 。 在 上 一 节 中 引用 到 的 token 或 者 tokenSession 拦截 器 ， 需 要 将 这 些 拦 
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截 器 代码 配置 注释 或 者 删除 掉 ， 因 为 ExecuteAndWaitInterceptor 不 能 和 token 和 tokenSession 
拦截 器 同时 使 用 ， 详 细 代码 如 下 所 示 。 


<action name="loginform" class="com.itzcn.action.LoginFormAction"> 
<result name="wait" type="freemarker"> 
/WEB-INF/freemarker/wait.html 

</result> 

<interceptor-ref name="token"/> 

<interceptor-ref name="execAndWait"> 

<param name="excludeMethods">default</param> 
</interceptor-ref> 
<result name="invalid.token">/error.jsp</result> 
<result name="success">/loginsuccess.jsp</result> 

</action> 


上 述 代 码 中 ， 使 用 result 节点 配置 execAndWait 拦截 器 ， 获 取 拦 截 后 转向 节点 中 配置 的 路 
径 内 。 
”ExecuteAndWaitInterceptor 也 是 从 MethodFilterInterceptor 继承 ,所 以 可 以 配置 排除 
注意 和 要 拦截 的 方法 列表 。 
同样 还 可 以 使 用 初始 等 待 延迟 ， 如 果 使 用 初始 等 待 延迟 ， 在 配置 execAndWait 拦截 器 时 ， 
使 用 delay 参数 ， 代 码 如 下 所 示 。 


<action name="login" class="action.LoginAction"> 
<interceptor-ref name="defaultstack" /> 


<interceptor-ref name="execAndWait"> // 使 用 execandwait 拦截 器 
<param name="delay">1000</param> // 配 置 delay 参数 

</interceptor-ref> 

<result name="wait">/wait.jsp</result> / /等待 页 面 wait .jsp 


<result name="success">/index.jsp</result> 
</action> 
在 上 面 的 代码 中 ， 配 置 execAndWait 拦截 器 ， 在 该 拦截 器 中 使 用 delay 参数 ， 并 设置 参数 
值 为 1000 毫秒 。 在 运行 程序 时 ， 服 务 器 首先 判断 如 果 在 1000 毫秒 之 内 ，Action 能 够 处 理 完 请 
求 , 将 不 显示 等 待 页 面 , 再 根据 Action 的 返回 结果 显示 相应 的 视图 。 如 果 在 1000 毫秒 内 , Action 
不 能 够 处 理 完 请 求 ， 则 向 用 户 显示 waitjsp 页 面 。 


10.2.4 运行 结果 
启动 Tomcat， 在 地 址 栏 里 面 输入 http://localhost:8080/ch10_1/login.action, 运行 结果 如 
图 10-4 所 示 。 


当 用 户 单 击 “ 登 录 ” 按 钮 之 后 ， 表 单 提 交 拦 截 器 进行 拦截 转向 等 待 页 面 ， 如 图 10-5 所 示 。 
同时 在 后 台 执 行 提 交 登 录 操作 。 登 录 成 功 之 后 将 看 到 图 10-6 所 示 的 页 面 。 


< 


10-5 登录 等 待 页 面 10-6 登录 成 功 页 面 


10.2.5 实例 分 析 


Ca 


通过 以 上 实例 可 以 将 用 户 提交 运行 时 间 较 长 的 程序 设置 后 台 运 行 ， 同 时 转向 提交 等 待 页 
面 ， 这 样 大 大 地 减少 了 用 户 不 断 提交 的 现象 。 而 且 在 视觉 上 也 比 拦截 重复 提交 的 效果 好 ， 在 该 
实例 中 ， 使 用 简单 的 ExecuteAndWaitInterceptor 拦截 器 就 完成 了 客户 所 需要 的 效果 ， 即 需要 在 
struts.xml 中 找到 需要 拦截 的 Action 即 可 。 


10.3 常见 问题 解答 


初次 请 求 提交 表单 被 拦截 器 拦截 ? 
网 络 课堂 : http://bbs.itzen.com/thread-10932-1-1.html 


在 本 章 的 第 一 节 中 讲解 到 了 使 用 拦截 器 拦截 表单 的 重复 提交 , 当 服 务 器 端 在 处 理 得 到 的 请 
求 之 前 ， 将 请 求 中 的 tokenl 与 保存 在 当前 用 户 session 中 的 值 进行 比较 ， 检 查 这 两 个 值 是 否 匹 


st) >> 
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配 。 如 果 相 等 ， 表 示 用 户 是 第 一 次 提交 该 表单 ， 清 除 session 中 的 token1， 然 后 执行 数据 处 理 
操作 ， 同 时 产生 一 个 新 的 token 值 ， 保 存 到 session 中 。 当 用 户 重 新 访问 提交 数据 页 面 时 ， 将 新 
产生 的 token2 作为 隐藏 输入 域 的 值 。 这样 ,如果 用 户 退 回 到 刚才 的 提交 页 面 并 再 次 提交 ， 客 户 
端 传 过 来 的 token 值 , 是 token1, 而 服务 器 端的 token 值 已 经 为 token2, 这 两 个 token 值 不 相等 ， 
将 不 再 对 用 户 的 请 求 进行 提交 ， 从 而 有 效 地 防止 了 重复 提交 的 发 生 。 但 是 万 事 总 不 是 我 们 想象 
中 那么 完美 ， 完 成 一 个 避免 表单 重复 提交 的 实例 之 后 ， 当 要 测试 的 时 候 ， 问 题 不 请 自 来 ， 因 为 
第 一 次 请 求 就 会 被 拦截 器 拦截 误 认 为 重复 提交 。 当 程序 出 现 这 样 的 错误 时 首先 检查 配置 信息 是 
否 正确 ， 拦 截 器 是 否 正常 工作 ， 最 后 就 是 在 表单 页 面 是 否 配置 了 标签 。 

<s:token/> 

在 运行 程序 请 求 该 页 面 文件 时 ， 在 运行 页 面 的 源 文件 中 ， 可 以 看 到 如 下 形式 的 代码 。 


<input type="hidden" name="struts.token" 
value="QAP2MPXRBP9SPRF2JVESUUHRDQ04Z51W" /> 


通过 以 上 配置 可 以 避免 除 此 请 求 就 被 拦截 器 拦截 。 


10.4 习 题 
一 、 填 空 题 
(1) Stmuts 2 框架 利用 机 制 ， 来 解决 Web 应 用 中 的 重复 提交 问题 。 
(2) 本 节 学 习 到 在 struts-default.xml 文件 中 ， 提 供 了 对 TokenInterceptor、 和 


ExecuteAndWaitInterceptor 拦截 器 的 配置 。 
(3) 由 于 拦截 器 按照 struts.xml 中 所 配置 的 顺序 依次 执行 ， 为 了 更 早 的 结束 重复 提交 的 处 
理 ， 应 该 将 拦截 器 放 在 所 有 拦截 器 的 前 面 。 
(4) 拦截 器 扩展 了 token 拦截 器 ， 但 是 tokenSession 拦截 器 不 会 返回 一 个 特殊 
的 结果 ， 也 不 会 添加 一 个 动作 错误 ， 只 是 阻 断后 面 的 提交 。 
(5) SexecAndWait 拦截 器 的 主要 参数 有 threadPriority ,delay 和 三 个 常用 参数 。 
二 、 选 择 题 
(1) tokenSession 拦截 器 的 实现 类 是 
A. TokenSessionStoreInterceptor B. TokenInterceptor 
C. ExecuteAndWaitInterceptor D. 上 述 全 不 是 
(2) 下 述 选项 中 那个 属于 execAndWait 拦截 器 的 参数 
A. class B. value C. delay D. priority 
(3) 在 TokenInterceptor 拦截 器 中 在 页 面 中 使 用 <s:token/> 语 名 添加 标签 ， 使 用 
输出 错误 信息 。 


A.，param 标签 B. text 标签 
C.，set 标签 D. actionerror 标签 


< 


三 、 上 机 练习 

上 机 练习 : 用 户 注 册 等 待 ， 防 止 用 户 重 复 提 交 。 

要 求 : 制作 一 个 会 员 注册 系统 如 图 10-7 所 示 ， 当 用 户 单 击 “注册 ”转向 一 个 注册 等 待 页 
面 如 图 10-8 所 示 ， 同 时 后 台 执行 注册 操作 ， 注 册 成 功 则 转向 成 功 提示 页 面 如 图 10-9 所 示 。 如 


果 用 户 单 击 浏览 器 “后 退 ” 按钮 重复 提交 能 容 则 提示 用 户 已 经 注册 成 功 的 消息 如 图 10-10 所 示 。 
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免费 注册 窗 内 网 只 二 四 KT 入骨 留 内 < 冯 卉 》 
人 


用 户 各 ; 段 刘 治 
请求 正 下 处理， 请 人 后， 
如 果 页 醒 汉 有 自动 重新 加 就 ， 请 单 古 这 里 


用 户 窑 罗 :admin 

确认 密码 : admin 
:duanshaozhi@126.com 
密 得 问题 : 作 是 陋 半 的 

密码 车 案 ， 中 国 的 


10-7 用 户 注册 页 面 10-8 ”注册 等 待 页 面 
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免费 注册 窗 内 网 只 汪 四 项 加 林立 风 注册 窗 内 ( 忆 填 ) 


免费 注册 窗 内 网 只 二 mame 机密 内 C 必 从 》 


振 尖 注册 已经 开 ， 滞 你 到 法 行 录 1 修 忆 经 注册 成 功 ，。 请 不 要 重复 注册 
The fom has Wenéy heen processed or ne lokm was nuppied please try in 


图 10-9 注册 成 功 页 面 图 10-10 重复 注册 提示 页 面 
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黄金 搭档 一 一 Strutsi2 集 成 
Spring 与 Hibernate 


内 容 摘 要 : 

Hibernate 是 持久 层 的 解决 方案 ，Struts 2 是 表现 层 的 解决 方案 ，Spring 是 一 个 集成 框架 。 
Struts 2 通过 插件 的 方式 来 集成 Spring， 在 添加 用 户 程序 中 ， 使 用 Spring 的 依赖 注入 功能 ， 为 
SaveUserAction 注入 它 依赖 的 UserDAO 对 象 。 本 章 将 介绍 Struts 2、Hibernate 和 Spring 的 集成 
开发 ， 简 称 SSH2 组 合 。 

学 习 目标 : 


理解 Hibernate 的 作用 。 

掌握 Hibernate 的 开发 。 

理解 Spring 的 作用 。 

掌握 Struts 2 和 Hibernate 的 集成 开发 。 

掌握 Struts 2、Hibernate 和 Spring 的 集成 开发 。 
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11.1 用户 注册 与 登录 


Java 是 面向 对 象 的 语言 ，SQL 是 结构 化 的 语言 ,数据 存储 在 关系 型 数据 库 中 。 在 对 象 技术 
与 关系 技术 结合 应 用 的 时 候 , 会 遇 到 一 个 问题 。 即 , 如 何以 面向 对 象 的 方式 来 操作 关系 型 数据 。 
这 种 需求 催生 了 对 象 关系 映射 (ORM) 技 术 ，Hibernate 适 着 其 时 地 出 现 , 得 到 了 广大 开发 者 的 青 
睐 ， 因 为 其 快速 的 普及 速度 ， 成 为 最 流行 的 对 象 关系 映射 框架 。 


A 
四 > 视频 教学 : 光盘 /videos/11/struts_hibernate.avi 侠 长 度 : 13 分 名 


11.1.1 基础 知识 一 一 集成 Hibernate 


本 节 将 简单 介绍 Hibernate， 和 其 基本 操作 ， 帮 助 读 者 快速 了 解 Hibernate 的 开发 。 
1. Hibernate 概述 


Hibermate 是 一 个 开放 源 代码 的 对 象 关系 映射 框架 ， 它 实现 ORM(Object-Relational 
Mapping， 对 象 关系 映射 )， 并 对 JDBC 进行 了 轻 量 级 的 对 象 封装 ， 使 得 Java 开发 者 可 以 随心 所 
欲 地 使 用 对 象 编程 思维 来 操纵 数据 库 ( 在 具体 的 操作 业务 对 象 时 ， 不 需要 和 复杂 的 SQL 语句 打 
交道 , 只 要 像 平 时 操作 对 象 一 样 )。Hibernate 可 以 应 用 在 任何 使 用 JDBC 的 场合 , 既 可 以 在 Java 
的 客户 端 程序 使 用 ， 也 可 以 在 Servlet/JSP 的 Web 应 用 中 使 用 。 最 具 革 命 意义 的 是 ，Hibernate 
可 以 在 应 用 EJB 的 J2EE 架构 中 取代 CMP， 完 成 数据 持久 化 的 重任 。 


2. Hibernate 的 优点 


Hibernate 是 JDBC 的 轻 量 级 的 对 象 封装 。 它 是 一 个 独立 的 对 象 持久 层 框架 , 和 App Server， 
和 EJB 没有 什么 必然 的 联系 。Hibernate 可 以 用 在 任何 JDBC 可 以 使 用 的 场合 ， 例 如 ，Java 应 
用 程序 的 数据 库 访 问 代 码 ，DAO 接口 的 实现 类 ， 甚 至 可 以 是 BMP 里 面 的 访问 数据 库 的 代码 。 
从 这 个 意义 上 来 说 ，Hibernate 和 EB 不 是 一 个 范畴 的 ， 也 不 存在 非 此 即 彼 的 关系 。 

Hibernate 是 一 个 和 JDBC 密切 关联 的 框架 ， 所 以 Hibernate 的 兼容 性 和 JDBC 驱动 以 及 数 
据 库 都 有 一 定 的 关系 ， 但 是 和 使 用 它 的 Java 程序 ， 和 App Server 没有 任何 关系 ， 也 不 存在 兼 
容 性 问题 。 

Hibernate 不 仅 管理 Java 类 到 数据 库 表 的 映射 (包括 Java 数据 类 型 到 SQL 数据 类 型 的 映射 )， 
还 提供 数据 查询 和 获取 数据 的 方法 ， 可 以 大 幅度 减少 开发 时 人 工 使 用 SQL 和 JDBC 处 理 数 据 


的 时 间 。 
Hibernate 能 在 众多 的 ORM 框架 中 脱颖而出 , 是 因为 Hibernate 与 其 他 ORM 框架 对 比 具 有 
如 下 优势 。 


@ ”开源 和 免费 的 License， 方 便 需 要 时 研究 源 代码 ， 改 写 源 代码 ， 进 行 功能 定制 。 
@ 轻 量 级 封装 ， 避 免 引 入 过 多 复杂 的 问题 ， 调 试 容易 ， 减 轻 开 发 者 的 负担 。 


mm >> 
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@ 具有 可 扩展 性 ，API 开放 。 功 能 不 够 用 时 ， 自 己 编码 进行 扩展 。 
@ ”使 开发 者 易于 活跃 ， 使 产品 有 稳定 的 发 展 方向 。 


3. Hibernate 的 下 载 和 安装 


Hibemate 目前 最 新 的 版 本 是 3.6.0， 本 章 使 用 的 也 是 这 个 版 本 ， 下 面 按 如 下 步骤 来 下 载 和 
安装 Hibernate。 

(1) 登录 到 “http://nchc.dl.sourceforge.net/project/hibernate/hibermmate3/3.6.0.Beta3/hibernate- 
distribution-3.6.0.Beta3-dist.zip” 即 可 下 载 ， 下 载 Hibernate 的 二 进 制 包 。Windows 平台 下 载 zip 
包 ，Linux 平台 下 载 tar 包 。 

(2) 解压 下 载 的 hibernate-distribution-3.6.0.Beta3-dist.zip 包 ， 在 hibernate-distribution- 
3.6.0.Beta3 路 径 下 有 一 个 hibernate3.jar 压缩 文件 ， 该 文件 时 Hibernate 的 核心 类 库 文件 。 该 路 
径 下 还 有 一 个 lib 目录 ， 该 目录 下 存放 了 Hibemate 编译 和 运行 的 第 三 方 类 库 。 

(3) 使 用 Hibemate 应 用 可 以 复制 hibemate3.jar 核心 类 库 文 件 ， 程 序 也 会 用 到 其 他 第 三 方 
类 库 可 以 根据 需要 到 lib 目录 下 进行 复制 使 用 。 

(4) 如 果 开 发 的 是 Web 应 用 ， 将 上 述 文件 复制 到 WEB-INF/lib 路 径 下 。 

(5) 如 果 要 在 控制 台 编 译 应 用 Hibermate API 类 ， 只 需 将 hibernate3.jar 文件 添加 到 
CLASSPATH 里 。 如 果 使 用 Ant 工具 ， 或 者 Eclipse 等 IDE 工具 ， 则 不 需要 修改 环境 变量 。 

本 书 实例 加 载 使 用 了 Hibernate 的 如 下 JAR 文件 。 

按照 上 述 五 个 步骤 完成 之 后 ， 就 可 以 使 用 Hibernate 进行 对 象 持 久 化 操作 了 。 


4. 使 用 Hibernate 向 数据 库 保存 记录 


使 用 Hibernate 保存 记录 也 就 是 将 对 象 持久 化 ， 既 然 要 持久 化 对 象 就 一 定 要 有 对 象 。 前 面 
已 经 说 过 ，Hibemate 是 一 个 低 侵入 性 的 开源 框架 ， 完 全 可 以 采用 一 般 的 Java 对 象 来 作为 持久 
化 对 象 使 用 。 一 个 一 般 的 持久 化 对 象 类 ， 代 码 如 下 所 示 。 


public class Clothes 1{ 


private int id; // 编 号 
private String name; // 名 称 
private string color; // 颜 色 
Private int price; // 价 格 
// 无 参 构造 函数 


public Clothes(){ 


} 
// 带 参 构造 函数 
public Clothes (String color, int id, String name, int price) { 
super (); 
this.color = color; 
this.id = id; 
this.name = name; 


this.price = price; 


< 
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// 下 面 是 id、name、color 和 price 属性 的 get 和 set 方法 ， 在 此 省 略 了 。 


上 述 代码 封装 了 一 个 简单 的 Clothes 实体 类 ， 这 个 类 与 普通 的 JavaBean 没有 任何 不 同 。 这 
就 是 Hibernate 的 低 侵入 性 的 体现 ， 不 需要 持久 化 类 继承 Hibemate 的 任何 父 类 ， 或 者 实现 任何 
接口 。 

仅仅 使 用 上 面 定义 的 一 个 普通 的 JavaBean 类 是 不 能 进行 持久 化 操作 的 ，Hibernate 采用 了 
XML 映射 文件 的 方式 来 实现 , 使 用 XML 文件 对 Clothes 实体 类 进行 映射 配置 , 代码 如 下 所 示 。 


<?xml Version="1.0"” encoding="UTF-8"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping> 
<class name="pojo.Clothes"> 
<id name="id"> 
<generator class="native" /> 
</id> 
<property name="name" /> 
<property name="color"/> 
<property name="price"/> 
</class> 
</hibernate-mapping> 


上 述 代 码 中 <hibernate-mapping> 元 素 是 Hibernate 映射 文件 的 根 元 素 , 这 对 于 所 有 的 映射 文 

件 都 是 相同 的 。 在 <hibernate-mapping> 元 素 中 添加 一 个 子 元 素 <class> 来 映射 Clothes 持久 化 类 ， 
使 用 <id> 元 素来 为 持久 化 类 映射 表 主 键 字 段 ，<property> 元 素 为 持久 化 类 映射 一 般 表 字 段 。 

通过 上 述 的 映射 信息 ,我 们 理解 了 持久 化 类 属性 与 数据 库 表 列 之 间 的 对 应 关系 ,但 不 知道 
要 连接 哪个 数据 库 以 及 连接 数据 库 时 所 用 的 连接 池 、 用 户 名 和 密码 等 详细 信息 。 这 些 信息 对 于 
所 有 的 持久 化 类 都 是 通用 的 ， 可 以 通过 XML 文件 来 配置 ， 代 码 如 下 所 示 。 

<?xml] version="1.0" encoding="UTF-8"?> 

<!-- 表 明 解 析 本 XML 文件 的 DTD 文档 位 置 ，DTD 是 Document Type Definition 的 缩写 ， 

即 文档 类 型 的 定义 , xML 解析 器 使 用 DTD 文档 来 检查 xML 文件 的 合法 性 


hibernate.sourceforge.net/hibernate-configuration-3.0dtd 可 以 在 
Hibernate3.2.5 软件 包 中 的 src\org\hibernate 目录 中 找到 此 文件 --> 
<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> 
<!-- 声 明 Hibernate 配置 文件 的 开始 --> 
<hibernate-configuration> 
<!-- 表 明 以 下 的 配置 是 针对 session-factory 配置 的 ，sessionFactory 是 Hibernate 
中 的 一 个 类 ， 这 个 类 主要 负责 保存 Hibernate 的 配置 信息 以 及 对 session 的 操作 --> 
<session-factory> 


<!- -配置 数据 库 的 驱动 程序 ，Hibernate 在 连接 数据 库 时 ， 需 要 用 到 数据 库 的 驱动 
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程序 -> 
<property name="hibernate.connection.driver class"> 
com.mysql.jdbc.Driver 
</property> 
<!-- 设 置 数据 库 的 连接 url:jdbc:mysql://localhost:port/test, 其 中 
localhost 表示 mysql 服务 器 名 称 ， 此 处 为 本 机 。port 代表 mysql 服务 器 的 端口 号 ， 
默认 是 3306。test 是 数据 库 名 ， 这 是 你 要 连接 的 数据 库 名 --> 
<property name="hibernate.connection.url"> 
jdbc:mysql://localhost:3309/struts2 hibernate 
</property> 
<property name="connection.useUnicode">true</property> 
<property name="connection.characterEncoding">utf-8</property> 
<!-- 如 果 你 的 mysql 服务 器 都 是 默认 设置 的 ， 且 装 在 本 机 器 上 ， 则 也 可 以 写成 
<property name="hibernate.connection.url"> 
jdbc:mysql://localhost/test 
</property> 或 
<property name="hibernate.connection.url"> 
jdbc:mysql:///test 
</property> 
--> 
<! 一 -连接 数据 库 的 用 户 名 -> 
<property name="hibernate.connection.username">root</property> 
<!-- 连 接 数据 库 的 密码 --> 
<property name="hibernate.connection.password">123456</property> 
<!--hibernate.dialect 是 Hibernate 使 用 的 数据 库 方言 ,就 是 要 用 Hibernate 连接 
哪 种 类 型 的 数据 库 服务 器 。--> 
<property name="dialect"> 
org.hibernate.dialect .MySQLDialect 
</property> 
<!--hibernate.hbm2ddl .auto 
指定 由 java 代码 生成 数据 库 脚 本 , 进而 生成 具体 的 表 结 构 的 具体 方式 --> 
<property name="hbm2ddl.auto">update</property> 
<!-- 是 否 在 后 台 显 示 Hibernate 生成 的 查询 数据 库 的 SQL 语句 ， 开 发 时 设置 为 true， 
便于 查询 错误 ， 程 序 运行 时 可 以 在 Eclipse 的 控制 台 显示 Hibernate 执行 的 sql 语句 。 
项 目 部 署 后 可 以 设置 为 false， 提 高 运行 效率 --> 
<property name="show sql">true</property> 
<!-- 开启 二 级 缓存 --> 
<property 
name="hibernate.cache.use second level cache">true</property> 
<!-- 指定 缓存 产品 提供 商 --> 
<property name="hibernate.cache.provider class"> 
org.hibernate.cache.EhCacheProvider</property> 
<!-- 启用 查询 缓存 --> 
<property name="hibernate.cache.use query cache">true</property> 
<!-- 指 定 映射 文件 为 "com/hibernate/dao/User.-hbm.xml"--> 
<mapping resource="pojo/Clothes.hbm.xml" /> 
</session-factory> 


</hibernate-configuration> 
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上 述 代码 配置 一 些 连 接 数据 库 的 驱动 、URL、 用 户 名 、 密码、 数据 库 连 接 池 的 大 小 ,等 等 。 
最 后 使 用 <mapping> 元 素 引 入 了 持久 化 类 的 映射 文件 。 
- 切 工作 准备 就 绪 后 ， 使 用 Hibernate 向 数据 库 中 保存 持久 化 类 对 象 对 应 的 记录 。 代 码 如 
下 所 示 。 


public class ClothesTest { 
public static void main (String[] args)throws Exception{ 

// 创 建 configuration 配置 信息 对 象 
Configuration conf = new Configuration() .configure() 7 
// 创 建 sessionFactory 对 象 
SessionFactory sf = conf.buildSessionFactory() 7 
/ /创建 session 对 象 
Session session = sf.openSession(); 
// 开 启事 务 
Transaction tx = session.beginTransaction(); 
// 创 建 clothes 实体 类 对 和 象 ， 并 为 属性 赋值 
Clothes clothes = new Clothes(); 
clothes .setColor ("红色 "); 
clothes .setName ("羊毛 大 衣 "); 
clothes.setPrice(289); 
// 保 存 实体 类 对 象 
session.save(clothes); 
// 提 交 事务 
tx.commit (); 
// 关 闭 Session 


session.close(); 


} 


使 用 session.save(clothes); 即 可 持久 化 对 象 到 数据 库 中 ， 完 全 是 面向 对 象 操作 。 运 行 上 述 
代码 ， 在 控制 台 上 输出 一 条 insert sql 语句 保存 对 象 ， 效 果 如 图 11-1 所 示 。 
电 加 PE TT OE 
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图 11-1 持久 化 Clothes 对 象 
5. 使 用 Hibernate 查 询 数 据 


Hibernate 不 仅 可 以 保存 数据 ， 也 可 以 查询 数据 。 它 支持 多 种 数据 查询 方式 , 包括 最 常用 的 
HQL 查询 ， 也 包括 原生 的 SQL 查询 。Hibemate 也 支持 条 件 查询 ， 条 件 查询 需要 使 用 以 下 三 个 
类 或 接口 : 

@ Criteria: 代表 一 次 条 件 查 询 。 

@ Criterion: 代表 一 个 查询 条 件 。 

@ 。 Restrictions: 产生 查询 条 件 的 工具 类 。 


>> 


第 11 章 黄金 搭档 一 一 Struts 2 集成 Spring 与 Hibernate 已: 


在 条 件 查询 中 ，Criteria 接口 代表 一 次 查询 。 该 查询 本 身 不 具备 任何 的 数据 筛选 功能 ， 
Session 调用 createCriteria(Class clazz) 方 法 对 某 个 持久 化 类 创建 条 件 查询 实例 。Criteria 常用 的 


方法 如 表 11-1 所 示 。 


表 11-1 Criteria 常 用 的 方法 


方法 名 称 作用 说 明 
add(Criterion criterion) 增加 查询 条 件 
addOrder(Order order 增加 排序 规则 
list0 List 返回 结果 集 
setFirstResult(int firstResult) Criteria 设置 查询 返回 的 第 一 行 记录 
setMaxResults(int maxResults, Criteria 设置 查询 返回 的 记录 数 


Criterion 接口 代表 一 个 查询 条 件 ， 这 个 查询 条 件 是 由 Restrictions 负责 产生 ，Restrictions 
是 一 个 用 于 产生 查询 条 件 的 工具 类 , 它 的 方法 大 部 分 都 是 静态 方法 , 常用 的 方法 如 表 11-2 所 示 。 
表 11-2 Restrictions 常 用 的 方法 


方法 名 称 作用 说 明 
between(String propertyName,Object lo.Object hi 判断 属性 值 在 某 个 值 范围 之 内 
allEq(Map propertyNameValues) a 2 全 机 
定 值 (参数 Map 的 value) 是 否 完全 相等 
ilike(String propertyName,Object value. 判断 属性 值 匹配 某 个 字符 串 
ilike(String propertyName.String value.MatchMode ey 判断 属性 值 匹 配 某 个 字符 串 ， 并 确定 
matchMode 匹配 模式 
in(String propertyName,Collection values) 判断 属性 值 在 某 个 集合 内 
in(String propertyName:Object[] values 判断 属性 值 是 数组 元 素 的 其 中 之 一 
isEmpty(String propertyName 判断 属性 值 是 否 为 空 
isNotEmpty(String propertyName) 判读 属性 值 是 否 不 为 空 
isNotNull(String propertyName, Criterion | 判断 属性 值 是 否 为 空 
isNull(String propertyName) Criterion | 判断 属性 值 是 否 不 为 空 
Dot(Criterion expression) Criterion 对 Criterion 求 否 
判断 某 个 属性 的 元 素 个 数 是 否 与 size 
sizeEq(String propertyName.int size) Criterion 相等 
sqlRestriction(String sqL Criterion 直接 使 用 SQL 语句 作为 筛选 条 件 


sqlRestriction(String sql.Object[] values.Type[] types) 


Criterion 


直接 使 用 带 参数 占 位 符 的 SQL 语句 作 
为 条 件 ， 并 指定 多 个 参数 值 


sqlRestriction(String sql.Object value.Type type) 


Criterion 


使 用 Hibernate 来 实现 一 次 条 件 查询 ， 代 码 如 下 所 示 。 


直接 使 用 带 参数 占 位 符 的 SQL 语句 作 
为 条 件 ， 并 指定 参数 值 
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public static void main(String[] args) throws Exception{ 

// 创 建 一 个 configuration 对 象 

Configuration conf = new Configuration() -configure() 7 

/ /创建 一 个 SessionFactory 对 象 

SessionFactory factory = conf.buildsessionFactory(); 

/ /创建 一 个 session 对 象 

Session session = factory.openSession(); 

// 开 启事 务 

Transaction tx = session.beginTransaction(); 

// 获 得 一 次 查询 条 件 对 象 

Criteria crit = session.createCriteria(Clothes.class); 

// 获 取 所 有 的 clothes 实体 对 象 

List LisE = rit list 

// 依 次 迭代 取出 clothes 对 象 并 将 对 象 名 称 与 价格 打印 出 来 

for (ListIterator iterator = list.listIterator();iterator.hasNext(); ) { 
Clothes clothes = (Clothes) iterator.next(); 
System.out .println ("衣服 名 称 : " + clothes.getName ()); 
System.out.println ("价格 : "+ clothes.getPrice()); 


} 


上 述 代 码 进行 了 一 次 条 件 查 询 ， 即 可 将 所 有 的 Clothes 实体 类 对 应 的 记录 都 查询 出 来 ， 并 
依次 迭代 取出 Clothes 对 象 ， 输 出 显示 衣服 名 称 和 价格 ， 执 行 效果 如 图 11-2 所 示 。 
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11-2 ”查询 Clothes 对 象 记录 
6. Struts 2 与 Hibernate 的 整合 方案 


在 Web 应 用 中 ， 作 为 MVC 的 优秀 框架 ，Struts 2 致力 于 与 用 户 交 互 的 层次 。 这 样 ， 可 以 
将 持久 层 交 给 Hibernate 来 管理 .Stmuts 2 与 Hibernate 两 个 框架 在 应 用 中 其 实 并 没有 直接 的 关联 ， 
它们 不 能 直接 交互 。 因此 , 要 想 整 合 Struts 2 与 Hibernate， 必 须 在 两 者 之 间 插 入 其 他 解决 方案 。 
如 图 11-3 所 示 Struts 2 与 Hibermate 的 整合 架构 方案 。 


i 


11-3 Struts 2 和 Hibernate 整 合 方案 


上 图 中 的 中 间 层 组 件 负 责 实现 Web 应 用 中 的 大 部 分 业务 操作 。 通 常 ， 中 间 层 分 为 如 下 两 
个 层 。 


sé >> 
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@ DAO 层 : 用 于 底层 持久 化 实现 ， 一 个 具体 的 DAO 组 件 只 能 与 特定 的 持久 化 技术 


Se 

@ ”业务 逻辑 层 ， 主要 用 于 实现 业务 罗 辑 ， 这 样 可 以 避免 与 持久 化 技术 耦合 。 

”使 用 Hibernate 框架 可 以 代替 JDBC 技术 ， 但 是 从 图 11-3 可 以 看 出 ， 在 Hibernate 

| 访问 数据 库 时 还 是 使 用 了 JDBC 技术 。 这 是 因为 Hibemate 的 数据 库 访问 建立 在 
JDBC 技术 的 基础 上 ， 只 不 过 在 应 用 中 不 需要 显 式 使 用 JDBC 编程 而 已 。 


ba 
部 


11.1.2 ”实例 描述 


昨天 完成 一 个 项 目 后 ， 闲 上 暇 之 余 ， 到 论坛 里 看 看 别人 发 表 的 帖子 。 从 发 帖 中 发 现 许 多 人 在 
学 习 Struts 2、Hiberate 和 Spring 的 整合 。 这 三 个 框架 确实 是 目前 非常 流行 的 框架 ， 而 且 我 刚 
做 的 一 个 项 目 也 是 使 用 S2SH 三 大 框架 做 的 。 因 为 这 三 个 框架 有 了 新 的 认识 ， 所 以 就 给 他 们 编 
写 了 一 个 例子 ,分 享 一 下 我 的 收获 。 本 实例 中 的 项 目 业 务 比较 简单 ， 便 于 读者 理解 ， 使 用 的 是 
Struts 2 和 Hibernate 两 个 主流 框架 做 的 。 


11.1.3 ”实例 应 用 


【 例 11-1】 用 户 注 册 与 登录 。 
(1) 新 建 一 个 Web 项目 Struts2_11。 在 项 目 src 目录 下 新 建 一 个 pojo 包 ， 在 该 包 下 新 建 一 
个 用 户 实体 类 User， 声 明 id、usemame、password、truename、sex、job 和 tip 属性 ， 代 码 如 下 
所 示 。 
Public ciass User { 
private int id; // 编 号 
private String username; // 用 户 名 


private String password; // 密 码 
private string truename; // 真 实 姓 名 


private string sex; // 性 别 
private string job; // 职 位 
private String tip; // 提 示 


// 下 面 是 属性 id、username、password、truename、sex、job 和 tip 的 get 和 set 方法， 
在 此 省 略 了 。 
1 


(2) 在 实体 类 User 所 在 目录 下 ， 新 建 一 个 Userhbm.xml 文件 ， 在 该 文件 中 配置 User 实体 
类 的 映射 数据 库 表 的 信息 。 代 码 如 下 所 示 。 

<?xml] Version="1.0" encoding="UTF-8"?> 

<!DOCTYPE hibernate-mapping PUBLIC 


"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 


< 
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用 于 存放 项 目 dao 层 组 件 , 即 本 实例 中 的 UserDao。 它 是 一 个 接口 ,定义 两 个 方法 ， 


<hibernate_mapping> 
<!-- 映射 实体 类 User --> 


<class name="pojo.User"> 


<!-- User 的 id 属性 映射 为 user 表 的 主键 ，native 表示 为 自 增 主 键 --> 


<id name="id"> 
<generator class="native" /> 
</id> 


<!-- 下 面 映射 User 的 username、 password 等 属性 为 user 表 的 对 应 字段 --> 


<property name="username" column: 


<property nam 


username"/> 


password" column="password"/> 
<property name="truename" column="truename"/> 
<property name="sex" column="sex"/> 


<property job" column="job"/> 
<property tip" column="tip"/> 
</class> 


</hibernate-mapping> 


(3) 通过 上 述 两 步 ， 持 久 层 已 经 完成 了 。 接 下 来 在 项 目 sre 目录 下 新 建 一 个 dao 包 ， 该 包 


用 于 查询 用 户 ， 另 一 个 是 save0 用 于 用 户 注册 。 代 码 如 下 所 示 。 


package dao; 

import java.util.Collection; 

import pojo.User; 

public interface UserDao { 
// 添 加 一 个 用 户 ， 即 可 以 用 于 用 户 注册 
public boolean save (User USseLr) 
// 查 询 用 户 名 为 name 的 用 户 
public User select (String name); 


| 


-个 是 select() 


(4) 新 建 一 个 dao.impl 包 , 在 该 包 下 新 建 一 个 UserDaoImpl 类 来 实现 dao 层 的 UserDao 接 


代码 如 下 所 示 。 
package dao.impl; 


import org.hibernate.Query; 
import org.hibernate.Transaction; 
import org.hibernate.Session; 
import pojo.User; 

import util.HibernateUtil; 

import dao.UserDao; 


public class UserDaoImpl implements UserDao { 
// 实 现 查 询 用 户 名 为 name 的 用 户 
public User select(String name) { 
User user = null; 
Session session = null; 


Transaction trans = null; 


第 11 章 黄金 搭档 一 一 Struts 2 集成 Spring 与 Hibernate 1 


try{ 
session = HibernateUtil.getSession(); 
trans = session.beginTransaction(); 
Query query = session.createQuery ("from User u where 
u.username= ?2"” ); 
query.setstring(0, name); 
if(null != query.list() || !query.list().isEmpty()){ 
user = (User) query.list() -get(0) 7 
} 
trans.commit (); 
} 
catch (Exception e){ 
trans.rollback (); 
e.printstackTrace () 7 
}finally{ 
session.close(); 
} 
return user; 
} 
// 保 存 用 户 user， 用 于 实现 用 户 注册 
public boolean save (User user){ 
Session session = null; 
Transaction trans = null; 
boolean result = false; 
try{ 
session = HibernateUtil.getSession(); 


trans = session.beginTransaction(); 
session.save (user); 
result = true; 
trans.commit () 7 

: 

catch (Exception e){ 
trans.rollback (); 
e.printstackTrace () 7 

}finally{ 
session.close(); 

, 


return result; 


(5) 在 项 目的 src 目录 下 新 建 一 个 action 包 ， 在 该 包 下 新 建 一 个 UserAction， 在 该 Action 
中 定义 一 个 register0 方 法 用 于 处 理 用 户 注 册 请 求 ， 重 新 继承 于 ActionSupport 类 的 execute0 方 
法 用 户 处 理 用 户 登 录 请 求 。 代 码 如 下 所 示 。 


package action; 


< 
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import pojo.User; 
import com.opensymphony .xwork2.Action; 
import com.opensymphony.xwork2.ModelDriven; 
import com.opensymphony.xwork2.ActionSupport; 
import com.opensymphony .xwork2.ActionContext; 
import dao.UserDao; 
import dao.impl.UserDaoImpl; 
public class UserAction extends ActionSupport implements ModelDriven<User>{ 
// 使 用 模型 驱动 
private User user = new User(); 
// 实 现 ModelDriven 接口 必须 实现 的 方法 
public User getModel (){ 
return user; 
} 
// 处 理 用 户 注册 
public String register(){ 
UserDao userDao = new UserDaoImpl (); 
boolean b = userDao.save (user); 
if(b){ 
return "siuccess"s 
}else{ 
getModel () .setTip ("注册 失败 ， 请 重新 注册 ! ") ; 


TEUrN "error™s 


} 

// 处 理 用 户 登录 

public String execute () throws Exception{ 
UserDao userDao = new UserDaoImpl (); 
User user = userDao.select (getModel () .getUsername ()); 
if(null != user ){ 


if(getModel () .getPassword() .equalsIgnoreCase (user.getPassword())){ 
getModel () .setTip ("服务 器 提示 ! ! ! "); 
//String user = (String) 
ActionContext .getContext () .getSession() .get ("user"); 
ActionContext .getContext () .getSession() .put ("user", 
getModel () .getUsername ()); 
return "success"; 
}elsef 
getModel () .setTip ("输入 用 户 名 或 密码 错误 ! ! ! ") ; 
return “error”? 
} 
}elsef{ 
getModel () .setTip ("没有 该 用 户 ! ! ! "); 


return "error™; 
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(6) 打开 项 目 src 目录 下 的 struts.xml 文件 , 在 该 文件 中 添加 UserAction 的 配置 信息 , 代码 
如 下 所 示 。 


<struts> 
<constant name="struts.il8n.encoding" value="UTF-8"/> 
<constant name="struts.custom.il8n.resources" value="messageResource"/> 
<package name="mystrut2" extends="struts-default"> 
<action name="Login" class="action.UserAction"> 
<result name="input">/login.jsp</result> 
<result name="error">/error.jsp</result> 
<result name="success">/login success.jsp</result> 
</action> 
<action name="register" class="action.UserAction" method="register"> 
<result name="error">/error.jsp</result> 
<result name="success">/login.jsp</result> 
</action> 
</package> 


</struts> 


(7) 新 建 一 个 registerjsp 页 面 ， 在 该 页 面 中 定义 一 个 form 表单 ， 供 用 户 输入 注册 信息 ， 
单 击 “ 注 册 ” 按 钮 ， 发 出 注册 请 求 ， 详 细 实 现代 码 如 下 所 示 。 


<body topmargin="30%"> 
<s:form action="register" method="post"> 
<table border="1"” cellspacing="0" align="center"> 
<caption align="center"> 用 户 注 册 </caption> 
EE 
<td><s:textfield name="username"” label=" 用 户 名 "/></td> 
</tr> 
E> 
<td><s:textfield name="password" label=" 密 码 "/></td> 
/Er> 
<tr> 
<td><s:textfield name="truename"” label=" 真 实 姓名 "/></td> 
</tr> 
< 
<td><s:textfield name="sex"” label=" 性 别 "/></td> 
</tr> 
<tr> 
<td><s:textfield name="job"” label=" 职 位 "/></td> 
</tr> 
<tr> 
<td><s:submit value=" 注 册 "/></td><td><s:reset value=" 重 置 "/></td> 
</tr> 
</table> 
</s:form> 
</body> 


< 
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(8) 新 建 一 个 loginjsp, 在 该 页 面 定义 一 个 用 于 用 户 登录 的 表单 ， 当 用 户 输入 用 户 名 密码 ， 
单 击 “ 登 录 ” 按 钮 时 ， 发 出 登录 请 求 ， 代 码 如 下 所 示 。 


<body> 
<s:form action="Login.action"> 
<h3> 用 户 登 录 </h3> 
<s:textfield name="username"” label=" 用 户 名 : "/> 
<s:textfield name="password" label=" 密 码 : "/> 
<s:submit value=" 提 交 "/> 
</s:form> 
</body> 


(9) 新 建 一 个 login_success.jsp 页 面 ， 当 用 户 登录 成 功 时 , 进入 登录 成 功 页 面 , 并 显示 “ 欢 
*+*#， 您 已 经 登录 成 功 ! ”， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@taglib prefix="s" uri="/struts-tags"%> 
<html> 
<head> 
<title> 登 录 页 面 </title> 
</head> 
<body> 
<h3><s:property value="tip"/></h3> 
欢迎 ，$ {sessionscope.user}， 您 已 经 登录 成 功 ! 
</body> 
</html> 


(10) 新 建 一 个 errorjsp 页 面 ， 当 用 户 登录 失败 时 ， 给 出 错误 提示 。 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%Q@taglib prefix="s" uri="/struts-tags"%®> 
<html> 
<head> 
<title> 错 误 </title> 
</head> 
<body> 


区 


<s:property value="tip"/> 
</body> 
</html> 


11.1.4 运行 结果 


打开 正 浏 览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_11/register.jsp”， 进 入 注册 
页 面 ， 执 行 效果 如 图 11-4 所 示 。 

当 用 户 输入 注册 信息 完毕 ， 单 击 “ 注 册 ” 按 钮 ， 将 进入 登录 界面 可 以 进行 登陆 ， 执 行 效果 
如 图 11-5 所 示 。 

单 击 “ 登 录 ” 按 钮 ， 登 录 成 功 后 ， 进 入 系统 欢迎 用 户 页 面 ， 如 图 11-6 所 示 。 


sé >> 
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11-6 ”欢迎 用 户 登录 


11.1.5 “实例 分 析 


让 ww 


本 实例 中 在 持久 层 定 义 了 一 个 User 实体 类 ， 并 在 dao 层 定义 了 一 个 操作 User 对 象 的 接口 
UserDao。 在 该 接口 中 声明 了 一 个 查询 用 户 对 象 的 select() 方 法 和 添加 用 户 对 象 的 save() 方 法 ， 
并 在 UserDaoImpl 类 中 实现 了 该 接口 。 

创建 一 个 UserAction 用 于 处 理 用 户 的 注册 和 登录 请 求 。 当 用 户 注 册 成 功 时 ， 跳 转 到 登录 页 
面 login.jsp 进行 登录 ， 和 登录 成 功 后 将 进入 欢迎 用 户 界面 ， 可 以 享受 用 户 相关 的 其 他 服务 。 


11.2 添加 用 户 


Spring 在 英文 里 有 春天 、 弹 筑 、 跳 跃 和 泉眼 的 意思 。Spring 也 表示 一 个 开源 框架 ， 是 为 了 


< 人 mm 
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解决 企业 应 用 程序 开发 复杂 性 ， 由 Rod Johnson 创建 的 。 框 架 的 主要 优势 之 一 是 其 分 层 架构 ， 
分 层 架 构 允许 使 用 某 一 个 组 件 ， 同 时 为 PEE 应 用 程序 开发 提供 集成 的 框架 。 


9 
国 .* 视频 教学 : 光盘 /videos/11/struts_spring.avi 全 长 度 : 6 分 钟 
光盘 /videos/11/struts_springl1.avi 图 长 度 : 12 分 钟 


11.2.1 基础 知识 一 一 集成 Spring 

前 面 已 经 提 到 过 ，Struts 2 通过 插件 的 方式 对 Spring 提供 支持 。Spring 的 依赖 注入 功能 以 
及 对 ORM 和 DAO 的 支持 ， 可 以 用 来 简化 Hibernate 的 配置 和 访问 操作 。 本 节 将 介绍 这 三 个 框 
架 的 集成 开发 。 

1. Spring 概述 


Spring 使 用 基本 的 JavaBean 来 完成 以 前 只 可 能 由 EJB 完成 的 事情 。Spring 的 用 途 不 仅 限 
于 服务 器 端的 开发 。 从 简单 性 、 可 测试 性 和 松 耦 合 的 角度 而 言 ， 任 何 Java 应 用 都 可 以 从 Spring 
中 受益 。 

传统 J2EE 应 用 的 开发 效率 低 ， 应 用 服务 器 厂商 对 各 种 技术 的 支持 并 没有 真正 统一 ， 导 致 
J2EE 的 应 用 没有 真正 实现 Write Once 及 Run Anywhere 的 承诺 。Spring 作为 开源 的 中 间 件 ， 独 
立 于 各 种 应 用 服务 器 ， 甚 至 无 须 应 用 服务 器 的 支持 ， 也 能 提供 应 用 服务 器 的 功能 ， 如 声明 式 事 
务 等 。 

Spring 致力 于 J2EE 应 用 的 各 层 的 解决 方案 ， 而 不 是 仅仅 专注 于 某 一 层 的 方案 。 可 以 说 
Spring 是 企业 应 用 开发 的 “一 站 式 ” 选 择 ， 并 贯穿 表现 层 、 业 务 层 及 持久 层 。 然 而 ，Spring 并 
不 想 取代 那些 已 有 的 框架 ， 而 是 与 它们 无 颖 地 整合 。 

2. Spring 带 来 的 好 处 与 优点 

在 进入 细节 以 前 ， 先 看 一 下 Spring 可 以 给 一 个 项 目 带 来 的 一 些 好 处 。 

@ Spring 能 有 效 地 组 织 中 间 层 对 象 ， 无 论 你 是 否 选择 使 用 EJB。 如 果 你 仅仅 使 用 了 

Stmts 或 其 他 的 包含 了 J2EE 特有 APIs 的 Framework， 你 会 发 现 Spring 关注 了 遗留 下 
的 问题 。 

@ Spring 能 消除 在 许多 项 目 上 对 Singleton 的 过 多 使 用 。 这 是 一 个 主要 的 问题 , 它 减少 了 

系统 的 可 测试 性 和 面向 对 象 特性 。 
@ Spring 能 消除 使 用 各 种 各 样 格式 的 属性 定制 文件 的 需要 ， 在 整个 应 用 和 项 目 中 ， 可 通 
过 一 种 一 致 的 方法 来 进行 配置 。 曾 经 感到 迷惑 ， 一 个 特定 类 要 查找 迷 幻 般 的 属性 关键 
字 或 系统 属性 ， 为 此 不 得 不 读 Javadoc 乃至 源 编码 吗 ? 有 了 Spring， 你 可 以 很 简单 地 
看 到 类 的 JavaBean 属性 。 倒 置 控制 的 使 用 可 以 (在 下 面 讨论 ) 帮 助 完 成 这 种 简化 。 

@ Spring 能 通过 接口 而 不 是 类 促进 好 的 编程 习惯 ， 将 编程 代价 减少 到 几乎 为 零 。 

@ Spring 被 设计 为 让 使 用 它 创 建 的 应 用 尽 可 能 少 的 依赖 于 它 的 APIs。 在 Spring 应 用 中 ， 
大 多 数 业务 对 象 没 有 依赖 于 Spring。 
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@ 使 用 Spring 构建 的 应 用 程序 易于 单元 测试 。 

@ Spring 能 使 EJB 的 使 用 成 为 一 个 实现 选择 ， 而 不 是 应 用 架构 的 必然 选择 。 可 以 选择 用 
POJOs 或 local EJBs 来 实现 业务 接口 ， 从 而 不 会 影响 调用 代码 。 

@ Spring 帮助 你 无 需 使 用 EJB 就 能 解决 许多 问题 。Spring 能 提供 一 种 EJB 的 替换 物 , 它 
们 适 于 许多 web 应 用 。 例 如 : Spring 能 使 用 AOP 提供 声明 性 事务 而 不 通过 使 用 EJB 
容器 ， 如 果 仅 仅 需要 与 单个 的 数据 库 打 交道 ， 甚 至 不 需要 JTA 实现 。 

@ Spring 为 数据 存 取 提供 了 一 致 的 框架 ， 不 论 是 使 用 JDBC 还 是 使 用 O/R mapping 产品 
(如 Hibemate)。 

Spring 使 你 通过 最 简单 可 行 的 办 法 解决 你 的 问题 。 这 些 特性 具有 很 大 价值 。 

总 结 起 来 ，Spring 有 如 下 优点 。 


@ 低 侵入 式 设 计 ， 代 码 污染 极 低 。 

@ ”独立 于 各 种 应 用 服务 器 ， 可 以 真正 实现 “一 次 编写 ， 处 处 运行 ”的 承诺 。 

@ Spring 的 DI 机 制 降低 业务 对 象 替换 的 复杂 性 。 

@ Spring 并 不 强制 Web 应 用 完全 依赖 于 Spring， 开 发 者 可 自由 选用 Spring 框架 的 部 分 
或 全 部 。 

@ Spring 为 数据 存储 提供 了 一 致 的 框架 ， 不 论 是 使 用 JDBC， 还 是 使 用 ORM( 例 如 
Hibernate)。 


3. 下 载 安 装 Spring 
在 Web 应 用 中 使 用 Spring 框架 ， 需 要 先 在 应 用 中 放置 Spring 的 相关 JAR 文件 。 下 载 和 安 
装 Spring， 可 以 按 如 下 步骤 进行 。 
(1) 登录 Spring 官方 网 站 “http://www.springsource.org” 站 点 ， 下 载 Spring 的 最 新 稳定 版 
本 。 本 书 中 采用 的 版 本 是 spring-framework-2.5.5-with-dependencies.zip。 
(2) 下 载 完 成 后 ， 解 压 zip 包 ， 解 压缩 后 的 spring-framework-2.5.5 文件 夹 中 有 如 下 几 个 文 
件 夹 。 
@ dist: 该 文件 夹 下 放 Spring 的 jar 包 ， 通常 只 需要 Springjar 文件 即 可 。 该 文件 夹 下 还 
有 一 些 类 似 spring-Xxx.jar 的 压缩 包 , 这 些 压缩 包 是 springjar 压缩 包 的 子 模块 压缩 包 。 
除非 确定 整个 J2EE 应 用 只 需要 使 用 Spring 的 某 一 方面 时 ， 才 考虑 使 用 这 种 分 模块 压 
缩 包 。 通 常 建议 使 用 Springjar。 
@ docs: 该 文件 夹 下 包含 spring 的 相关 文档 、 开 发 指南 及 API 参考 文档 。 
@ lib: 该 文件 夹 下 包含 spring 编译 和 运行 所 依赖 的 第 三 方 类 库 ， 该 路 径 下 的 类 库 并 不 是 
spring 必需 的 ， 但 如 果 需 要 使 用 第 三 方 类 库 的 支持 ， 这 里 的 类 库 就 是 需要 的 。 
@ samples: 该 文件 夹 下 包含 Spring 的 几 个 简单 例子 ， 可 作为 Spring 入 门 学 习 的 案例 。 
@ src: 该 文件 夹 下 包含 Spring 的 全 部 源 文件 ， 如 果 开 发 过 程 中 有 些 地方 无 法 把 握 ， 可 
以 参考 该 源 文件 ， 了 解 底层 实现 。 
@ test: 该 文件 夹 下 包含 Spring 的 测试 示例 。 
@ tiger: 该 路 径 下 存放 关于 JDK 的 相关 内 容 。 
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@ 其 他 相关 文件 ， 解压 缩 后 的 文件 夹 下 ， 还 包含 一 些 关于 Spring 的 License 和 项 目 相关 

文件 。 

(3) 将 spring.jar 复制 到 项 目的 CLASSPATH 路 径 下 , 对 于 Web 应 用 , 将 spring.jar 文件 复 
制 到 WEB-INF/lib 路 径 下 ， 该 应 用 即 可 以 利用 Spring 框架 了 。 

(4) 通常 Spring 的 框架 还 依赖 于 其 他 一 些 jar 文件 ， 因 此 还 须 将 lib 下 对 应 的 包 复制 到 
WEB-INF/lib 路 径 下 ， 具 体 要 复制 哪些 jar 文件 ， 取 决 于 应 用 所 需要 使 用 的 项 目 。 通 常 需要 复 
制 cglib，dom4j，jakarta-commons，log4j 等 文件 夹 下 的 jar 文件 。 

4. Spring 框 架 组 件 

Spring 框架 是 一 个 分 层 架构 ， 由 7 个 定义 良好 的 组 件 组 成 。Spring 组 件 构建 在 核心 容器 之 
上 ， 核 心 容器 定义 了 创建 、 配 置 和 管理 Bean 的 方式 。 组 成 Spring 框架 的 每 个 组 件 都 可 以 单独 
存在 ， 或 者 与 其 他 一 个 或 多 个 组 件 联 合 实现 。 这 7 个 组 件 如 下 。 

1) Spring Core 

Spring Core 是 Spring 的 核心 容器 ， 它 提供 Spring 框架 的 基本 功能 。 核 心 容器 的 主要 组 件 
是 BeanFactory， 它 是 工厂 模式 的 实现 。BeanFactory 使 用 IoC 模式 将 应 用 程序 的 配置 和 依赖 性 
规范 与 实际 的 应 用 程序 代码 分 开 。 

2) Spring Context 

Spring Context 是 一 个 配置 文件 ， 向 Spring 框架 提供 上 下 文 信息 。 

@ $》 Spring Context 包括 企业 服务 ， 例 如 : JNDI、EJB、 电 子 邮 件 、 国 际 化 、 校 验 和 调 
组 示 | 。 度 功能 等 。 


3) Spring AOP 
通过 配置 管理 特性 ，Spring AOP 直接 将 面向 切面 的 编程 功能 集成 到 了 Spring 框架 中 。 所 
以 ， 可 以 很 容易 使 Spring 框架 管理 的 任何 对 象 支持 AOP。 
Spring AOP 为 基于 Spring 的 应 用 程序 中 的 对 象 提供 了 事务 管理 服务 。 通 过 使 用 
二 示 | 。 Spring AOP， 不 用 依赖 EJB 组 件 ， 就 可 以 将 声明 性 事务 管理 集成 到 应 用 程序 中 。 
4) Spring DAO 
JDBC DAO 抽象 层 提供 了 有 意义 的 异常 层次 结构 , 可 以 用 该 结构 来 管理 异常 处 理 和 不 同 数 
据 库 供应 商 抛 出 的 错误 消息 .Spring DAO 的 面向 JDBC 的 异常 遵从 通用 的 DAO 异常 层次 结构 。 
$ 异常 层次 结构 简化 了 错误 处 理 ， 并 且 极 大 地 降低 了 需要 编写 的 异常 代码 数量 (例如 
组 示 | 。 打开 和 关闭 连接 )。 
5) Spring ORM 
Spring 框架 插入 了 若干 个 ORM 框架 ， 从 而 提供 了 ORM 的 对 象 关系 工具 。 
6) Spring Web 
Spring 框架 支持 与 Jakarta Struts 的 集成 。Spring Web 组 件 简化 了 处 理 多 部 分 请 求 以 及 将 请 
求 参 数 绑 定 到 域 对 象 的 工作 。 
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7) Spring Web MVC 
Spring MVC 框架 是 一 个 全 功能 的 构建 Web 应 用 程序 的 MVC 实现 。 通过 策略 接口 , Spring 
MVC 框架 变 成 为 高 度 可 配置 的 。 


0 | Spring MVC 容纳 了 大 量 视图 技术 ， 其 中 包括 JSP、Velocity 和 Tiles 等 。 


Spring 框架 的 组 件 结构 如 图 11-7 所 示 。 


| 
| 
i 


11-7 Spring 框架 的 组 件 结构 


5. Spring 的 loC 容 器 

IoC， 全 称 (Inverse Of Control)， 中 文 意思 为 : 控制 反 转 ，Spring 框架 的 核心 基于 控制 反 转 
原理 。 

什么 是 控制 反 转 ? 控制 反 转 是 一 种 将 组 件 依 赖 关 系 的 创建 和 管理 置 于 程序 外 部 的 技术 。 由 
容器 控制 程序 之 间 的 关系 ， 而 不 是 由 代码 直接 控制 。 由 于 控制 权 由 代码 转向 了 容器 ， 所 以 称 为 
反 转 。 

在 Spring 中 ， 当 一 个 角色 A 需要 另 一 个 角色 B 协助 工作 时 ，Spring 容器 负责 调用 B， 而 
不 需要 A 自己 去 调用 ， 这 被 称 为 控制 反 转 ， Spring 容器 创建 B 的 实例 ， 然 后 注入 给 A， 称 为 
依赖 注入 。 这 两 者 说 的 是 同一 件 事情 。 

(1) 下 面 举 一 个 简单 的 例子 来 介绍 依赖 注入 的 使 用 。 创 建 一 个 Person 接口 ， 定 义 一 个 
useAxe() 方 法 ， 代 码 如 下 所 示 。 


package com.IoC; 


public interface Person { 
/太太 
* 使 用 佐 子 
>/ 
public void useAxe(); 
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(2) 创建 一 个 Axe 接口 ， 定 义 一 个 chop0 方 法 ， 代 码 如 下 所 示 。 


package com.IoC; 
public interface Axe { 
/*# 
* 砍 的 方法 
和 
public String chop(); 


(3) 创建 一 个 Chinese 类 实现 Person 接口 ， 代 码 如 下 所 示 。 


package com.IoC; 


public class Chinese implements Person{ 
private Axe axe; 
/太太 
* 设 值 注入 所 需 的 setter 方法 
* Q@param axe 
a 
public void setAxe (Axe axe) 
{ 
this.axe = axe; 
} 
public void useAxe() { 
System.out .println (axe.chop()); 


| 
(4) 创建 一 个 StoneAxe 类 实现 Axe 接口 ， 代 码 如 下 所 示 。 


package com.IocC; 
public class StoneAxe implements Axe{ 
public String chop() { 
return "这 是 一 把 砍 得 很 慢 的 破 丛 子 ! "; 


} 
(5) 在 Spring 的 配置 文件 中 对 实现 类 进行 配置 ， 配 置 文件 的 内 容 如 下 代码 所 示 。 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"> 
<!-- 以 上 是 全 部 Spring 都 一 样 的 配置 文件 、beans 是 根 元 素 --> 
<bean name="chinese" class="com.IoC.Chinese"> 
<property name="axe"> 
<!-- 如 果 注 入 的 是 基本 类 型 则 用 value、 如 果 是 引用 类 型 则 使 用 ref --> 
<ref local="StoneAxe"/> 
</property> 
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</bean> 
<bean id="StoneAxe" class="com.IoC.StoneAxe"></bean> 
</beans> 


傅 =” StoneAxe 类 有 一 个 使 用 关子 的 方法 ， 而 Chinese 类 是 使 用 芥子 的 人 。XML 配置 文 
技巧 件 里 面 声明 两 个 bean， 但 是 StoneAxe 是 Chinese 的 一 个 属性 ， 但 是 value 用 于 基 
本 类 型 ， 而 ref 用 于 引用 类 型 。 运 行 Chinese 的 时 候 ， 提 供 调用 useAxe() 进 行使 用 

“ 乔 子 ”， 要 引进 StoneAxe 则 通过 seter 方法 ， 进 行 后 面 的 属性 注入 。 


11.2.2 ”实例 描述 


刚 登 上 QQ， 就 是 铺天盖地 的 群 信息 。 看 看 这 都 是 谁 发 的 ， 一 看 又 是 老 一 套 ， 信 息 上 是 在 
求助 帮忙 找 一 个 Struts 2、Hibemate 和 Spring 集成 的 项 目 源码 , 说 是 紧急 使 用 。 看 他 着 实 可 怜 ， 
心中 实在 不 忍 ， 于 是 我 给 他 写 了 一 个 添加 用 户 的 例子 ,现在 拿 出 来 和 读者 共同 学 习 一 下 。 实 际 
上 这 三 大 框架 的 整合 并 没有 读者 想象 的 那么 难 ， 看 看 下 面 的 实例 就 知道 了 。 


11.2.3 ”实例 应 用 


【 例 11-2】 添加 用 户 。 
(1) 创建 一 个 Struts2_SH 项 目 ， 然 后 将 Struts 2、Hibernate、Spring 所 需 JAR 包 复 制 粘贴 
到 项 目的 WEB-INF/lib 目录 下 。 最 后 在 项 目的 src 目录 下 新 建 一 个 com.test.bean 包 ， 在 该 包 下 
新 建 一 个 用 户 实体 类 User， 包 含 firstname、lastname 和 age 属性 ， 代 码 如 下 所 示 。 


public class User { 
private int id; // 用 户 编号 
private String firstname;  // 用 户 的 姓 
private string lastname; // 用 户 的 名 
private int age; // 用 户 的 年 龄 
} 


(2) 在 User 实体 类 所 在 目录 下 ， 新 建 一 个 User.hbm.xml 文件 来 映射 User 类 ， 代 码 如 下 
所 示 。 


<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 
3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping> 
<class name="com.test.bean.User" table="users"> 
<id name="id"> 
<generator class="native" /> 
</id> 
<property name="firstname" ></property> 


<property name="lastname"></property> 


< 
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<property name="age"></property> 
</class> 


</hibernate-mapping> 


(3) 设计 项 目的 DAO 层 ,在 项 目的 src 目录 下 新 建 一 个 com.test.dao 包 ， 在 该 包 下 新 建 一 


个 UserDAO 接口 ， 声 明 一 个 添加 用 户 方法 和 一 个 查询 所 有 用 户 信息 的 方法 ， 代 码 如 下 所 示 。 


Package com.test.dao; 


import java.util.List; 
import com.test.bean.User; 


public interface UserDRO { 
// 添 加 一 个 用 户 
public void saveUser (User user) 
// 查 询 所 有 用 户 信息 
public List<User> findAllUsers () 
} 


(4) 在 项 目 src 目录 下 ， 新 建 一 个 com.test.dao.impl 包 ， 在 该 包 下 新 建 一 个 UserDAOImpl 
该 类 需要 实现 UserDAO 接口 ， 代 码 如 下 所 示 。 


public class UserDAOImpl extends HibernateDaoSupport implements UserDRO { 

// 查 询 所 有 用 户 信息 

@suppressWarnings ("unchecked") 

public List<User> findAllUsers() { 
String hql="from User"; 
return (List<User>)this.getHibernateTemplate() .find(hql); 

此 

// 添 加 一 个 用 户 

public void saveUser (User user) { 
this.getHibernateTemplate() .save (user); 


} 
(5) 在 项 目 src 目录 下 ， 新 建 一 个 com.test.service 包 ， 在 该 包 下 定义 一 个 业务 逻辑 层 接口 


UserService， 处 理 添加 用 户 和 查询 所 有 用 户 信息 的 业务 逻辑 ， 代 码 如 下 所 示 。 


package com.test.service; 
import java.util.List; 
import com.test.bean.User; 


public interface UserService { 
// 查 询 所 有 用 户 信息 
public List<User> findAll(); 
// 添 加 一 个 用 户 


public void save (User user); 
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(6) 在 项 目 src 目录 下 ， 新 建 一 个 comtest.service.impl 包 ， 在 该 包 下 定义 一 个 UserService 
Impl 类 ， 该 类 需要 实现 业务 逻辑 接口 UserService， 代 码 如 下 所 示 。 


package com.test.service.impl; 


import 
import 
import 
import 


public 


java.util.List; 

com.test .bean.User; 
com.test.dao.UserDAO; 
com.test.service.UserService; 


class UserServiceImpl implements UserService { 


private UserDAO userDao; // 声 明 一 个 UserDao 对 象 


public UserDRO getUserDao () { 


return userDao; 


public void setUserDao (UserDAO userDao) { 


} 


this.userDao = userDao; 


// 查 询 所 有 用 户 信息 
public List<User> findAll() { 


3} 


return this.userDao.findAllUsers (); 


// 保 存 一 个 用 户 


public void save (User user) { 


|， 


this.userDao.saveUser (user); 


(7) 业务 逻辑 层 完成 之 后 ， 开 始 控 制 器 层 的 设计 。 在 项 目的 src 目录 下 ， 新 建 一 个 
com.test.action 包 ， 在 该 包 下 新 建 一 个 SaveUserAction， 用 于 处 理 添加 保存 用 户 请 求 ， 代 码 如 下 


所 示 。 


package com.test.action; 


import 
import 
import 
import 
import 


public 


javax.servlet.http.HttpServletRequest; 
org.apache.struts2.ServletActionContext; 
com.opensymphony .Xxwork2 .ActionSupport; 
com.test.bean.User; 


com.test.service.UserService; 


class SaveUserAction extends ActionSsupport { 


private User user = new User(); // 创 建 一 个 用 户 对 象 
private UserService service; // 创 建 处 理 用 户 操作 业务 对 象 


public User getUser() { 


< 人 mm 
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return user; 


public void setUser (User user) { 


this.user = user; 


public UserService getService() { 
return service; 


public void setService(UserService service) { 
this.service = service; 


@Override 
public String execute() throws Exception { 
this.service.save (this.user); // 保 存 用 户 


return SUCCESS; 


} 


(8) 在 com.test.action 包 下 ， 再 新 建 一 个 UserListAction， 用 于 查询 获取 所 有 用 户 
码 如 下 所 示 。 


package com.test.action; 


import java.util.List; 

import com.opensymphony .xwork2.ActionSsupport; 
import com.test.bean.User; 

import com.test.service.UserService; 


public class UserListAction extends ActionSupport{ 
private UserService service; / /创建 处 理 用 户 操 作业 务 对 象 
private List<User> list; / /创建 一 个 存储 用 户 信息 的 列表 
public List<User> getList() { 
return list; 
上 
public void setList (List<User> list) { 
thiss1ist = 1ist? 
} 
public UserService getService() { 
return service; 
} 
public void setService(UserService service) { 
this.service = services; 
} 
Boverride 


public String execute () throws Exception { 


s(t >> 


Gh 


外， 代 
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list = this.service.findAll(); // 查 询 获取 所 有 用 户 信息 列表 


return "Success” 7 


(9) 在 项 目 src 目录 下 新 建 一 个 struts.xml 文件 。 在 该 文件 中 添加 SaveUserAction 和 
UserListAction 的 配置 ， 代 码 如 下 所 示 。 


<?xml Version="1.0"” encoding="UTF-8"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<package name="struts2" extends="struts-default"> 
<action name="SaveUser" class="saveuseraction"> 
<result name="success" type="redirect">list.action</result> 
<result name="input">/save.jsp</result> 
</action> 
<action name="list" class="userlistaction"> 
<result>/list user.jsp</result> 
</action> 
</package> 
</struts> 


(10) 上 述 是 对 Action 的 配置 ,下 面 使 用 Spring 来 配置 Hibernate 和 UserDAO、UserDAOImpl、 
UserService 和 UserServiceImpl 一 系列 bean， 还 有 Action 的 注入 配置 ， 代 码 如 下 所 示 。 


<?xml version="1.0" encoding="UTF-8"?> 
<beans 
xmlns="http://www.springframework.org/schema/beans" 
xmlns:XSi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"> 
<!-- 连接 数据 库 的 数据 源 的 配置 --> 
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"> 
<property name="driverClassName" 
value="com.mysql .jdbc.Driver"></property> 
<property name="url" 
value="jdbc:mysql://localhost:3306/spring"></property> 
<property name="username" value="root"></property> 
<property name="password" value="123456"></property> 
<property name="maxActive" value="100"></property> 
<property name="maxIdle" value="30"></property> 
<property name="maxWait" value="500"></property> 
<property name="defaultAutoCommit" value="true"></property> 
</bean> 
<!-- Hibernate 的 sessionFactory 的 配置 --> 
<bean id="sessionFactory" 


class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> 


< 
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<property name="dataSource" ref="dataSource"></property> 
<property name="hibernateProperties"> 
<props> 
<prop 
key="hibernate.dialect">org.hibernate.dialect.MySQLDialect</prop> 
<prop key="hibernate.show-sql">true</prop> 
</props> 
</property> 
<property name="mappingResources"> 
<list> 
<value>com/test/bean/User.hbm.xml</value> 
</list> 
</property> 
</bean> 
<!-- UserDAOImpl 的 注入 配置 --> 
<bean id="userDao" class="com.test.dao.impl.UserDAOImpl"> 
<property name="sessionFactory"> 
<ref bean="sessionFactory"/> 
</property> 
</bean> 
<!-- UserServiceImpl 的 注入 配置 --> 
<bean id="userService" class="com.test.service.impl.UserServiceImpl"> 
<property name="userDao"> 
<ref bean="userDao"/> 
</property> 
</bean> 
<!--SaveUserAction 的 注入 配置 --> 
<bean id="saveuseraction" class="com.test.action.SaveUserAction"> 
<property name="service" ref="userService"></property> 
</bean> 
<!-- UserListAction 的 注入 配置 --> 
<bean id="userlistaction" class="com.test.action.UserListAction"> 
<property name="service" ref="userService"></property> 
</bean> 
</beans> 


(11) 打开 项 目 WEB-INF 目录 下 的 web.xml 文件 ， 在 该 文件 中 添加 spring 的 Context 
LoaderListener 监听 器 和 Struts 2 的 FilterDispatcher 拦截 器 ， 代 码 如 下 所 示 。 


<?xml] version="1.0" encoding="UTF-8"?> 

<web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app 2_ 5.xsd"> 
<listener> 


<listener-class>org.springframework.web.context.ContextLoaderListener</ 


listener-class> 


sd >> 
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</listener> 
<filter> 
<filter-name>struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-cl 
ass> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 
</web-app> 


(12) 上 述 配置 完毕 , 在 项 目 目录 下 新 建 一 个 index.jsp 页 面 , 该 页 面 可 以 为 用 户 提 供 一 个 添 
加 用 户 链接 和 一 个 查询 所 有 用 户 信 息 链接 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<%@ taglib prefix="s" uri="/struts-tags" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 用 户 系统 </title> 
</head> 
<body> 
<s:a href="save.jsp"> 添 加 用 户 </s:a><br><br/> 
<s:a href="1list.action"> 查 询 所 有 用 户 信息 </s:a> 
</body> 
</html> 


(13) 当 用 户 单 击 “ 添 加 用 户 ” 链 接 时 ， 跳 转 到 save.jsp 页 面 ， 该 页 面包 含 一 个 用 户 信 息 表 
单 ， 输 入 用 户 信息 之 后 ， 可 单 击 “ 保 存 ” 按 钮 ， 保 存 用 户 信息 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<%@ taglib prefix="s" uri="/struts-tags" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 添 加 用 户 </title> 
</head> 
<body> 
<s:form action="SaveUser"> 
<s:textfield name="user.firstname" label=" 姓 "></s:textfield> 
<s:textfield name="user.lastname" label=" 名 "></s:textfield> 
<s:textfield name="user.age"” label=" 年 龄 "></s:textfield> 
<s:submit value=" 保 存 "></s:submit> 
</s:form> 
</body> 
</html> 


(14) 当 保存 用 户 成 功 时 ， 将 转发 到 list.action 查询 显示 用 户 信 息 ， 查 询 成 功 页 面 跳 转 到 


< 


list_user.jsp 页 面 ， 显 示 所 有 用 户 的 信息 ， 代 码 如 下 所 示 。 
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<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<$%Q@ taglib prefix="s" uri="/struts-tags" $%> 
<!IDOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 显 示 用 户 信息 </title> 
</head> 
<body> 
<table> 
<s:iterator value="list" id="name" status="status"> 
<tr <s:if 
test="#status.odd">style="background-color:yellow"</s:if>> 
<td><s:property value="#status.count"/></td> 
<td> 姓 : <s:property value="firstname"/></td> 
<td> 名 : <s:property value="lastname"/></td> 
<td> 年 龄 : <s:property value="age"/></td> 
</tr> 
</s:iterator> 
</table> 
</body> 
</html> 


.2.4 运行 结果 


打开 正 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_SH/index.jsp”， 进 入 用 户 


管理 系统 ， 可 以 添加 用 户 和 查看 用 户 信息 ， 执 行 效果 如 图 11-8 所 示 。 


看 月 


图 11-8 用 户 管理 系统 


单 击 “ 添 加 用 户 ” 链 接 ， 可 以 添加 一 个 新 用 户 ， 单 击 “ 查 询 所 有 用 户 信息 ”链接 ， 可 以 查 


日 户 信息 ， 添 加 用 户 执行 效果 如 图 11-9 所 示 。 
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添加 用 户 完成 之 后 ， 页 面 跳 转 到 显示 用 户 信 息 页 面 ， 执 行 效 果 如 图 11-10 所 示 。 
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图 11-9 添加 用 户 图 11-10 显示 用 户 信息 


11.2.5 ”实例 分 析 


a 


本 实例 主要 是 操作 用 户 ， 首 先 创建 一 个 User 实体 类 ， 并 编写 User 类 的 映射 数据 库 表 的 配 
置 文件 Userhbm .xml。 设计 DAO 层 创建 UserDAO 接口 ， 声 明 一 个 添加 用 户 方法 和 一 个 查询 所 
有 用 户 信息 方法 ,并 新 建 UserDAOImp1 类 实现 UserDAO 接口 ,业务 逻辑 层 新 建 一 个 UserService 
接口 ， 声 明 两 个 业务 逻辑 方法 ， 添 加 用 户 方法 和 查询 所 有 用 户 信息 方法 ， 再 新 建 一 个 
UserServiceImpl 类 实现 UserService 接口 。 

然后 实现 控制 器 层 ， 编写 两 个 Action: SaveUserAction 和 UserListAction, 分 别 用 于 处 理 添 
加 用 户 请 求 和 查询 用 户 请 求 。 并 在 struts.xml 文件 中 添加 这 两 个 Action 的 相应 配置 信息 。 

最 后 添加 applicationContext.xml 配置 文件 ， 配 置 Hibernate 相关 信息 和 DAO 层 、 业 务 逻 辑 
层 和 控制 器 层 类 的 注入 配置 。 再 新 建 一 个 save.jsp 页 面 用 于 保存 用 户 ，list_user.jsp 页 面 用 于 显 
示 用 户 信息 。 


11.3 ”常见 问题 解答 


11.3.1 ”Struts 2+Hibernate+Spring 整 合 错误 严重 :Exception starting 
filter struts 2 


Struts 2+Hibernate+Spring 整合 错误 严重 :Exception starting filter struts 2? 
网 络 课堂 : http://bbs.itzcn.com/thread-11007-1-1.html 


< 人 mm 
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Stmuts 2+Hibernate+Spring 整合 项 目 ， 运 行 时 ， 控 制 台 输 出 如 下 错误 信息 。 


严重 : 了 Exception starting filter struts2 

java.lang.RuntimeException: java.lang.RuntimeException: 
java.lang.RuntimeException: 

com.opensymphony .xwork2.inject .DependencyException: 

com.opensymphony .xwork2.inject.ContainerImpl$MissingDependencyException: No 
mapping found for dependency [type=java.lang.string, 
name="'struts.objectFactory.spring.autoWire.alwaysRespect'] in public 
org.apache.struts2.spring.SstrutsspringObjectFactory (java.lang.Sstring,java.l1 
ang.Sstring,java.lang.Sstring,javax.servlet.ServletContext). 


不 知 该 如 何 解决 ， 请 各 位 高 手 帮忙 解答 。 

【解决 办 法 】: 出 现 这 种 错误 ， 可 能 是 因为 如 下 几 种 原因 。 

(1) 有 可 能 是 jar 包 互 相 冲 突 ， 这 个 没有 好 办 法 ， 只 有 一 个 一 个 去 试 了 。 

(2) 有 可 能 是 Struts 2 的 配置 文件 里 面 的 Action 的 路 径 写 错 了 ， 查 看 一 下 struts.xml 文件 。 
(3) 也 有 可 能 是 web.xml 中 的 filter 写 错 了 。web.xml 里 加 入 如 下 代码 。 

<listener> 
<listener-class>org.springframework.web.context.ContextLoaderListener</list 


ener-class> 
</listener> 


还 必须 添加 struts2-spring-plugin-2.1.6.jar 包 。 
11.3.2 ”出现 java.lang.NoClassDefFoundError 问 题 


出 现 java.lang.NoClassDefFfoundError:org 问题 ? 
网 络 课堂 : http:Wbbs.itzcn.comy/thread-11017-1-1.html 
我 第 一 次 整合 SpringtHibematetStruts 2 项 目 ， 整 合 完毕 之 后 运行 ， 在 控制 台 输 出 
“java.lang.NoClassDefFoundError:org/slf4j/LoggerFactory” 错 误 ， 不 知 该 如 何 解 决 。 
【解决 办 法 】: 出 现 这 个 错误 是 因为 项 目 中 缺少 jar 包 ， 你 可 以 加 入 slf4j-api-1.5.0.jar、 
slf4j-log4j12-1.5.0.jar、log4j-1.2.15jar 包 试 一 试 。 


11.3.3 org.hibernate.id.ldentifierGenerationException 异 常 问题 


回 &4 org.hibernate.id.IdentifierGenerationException 是 什么 异常 ， 如 何 解 决 ? 
[富田 网 络 课堂 : http://bbs.itzcn.com/thread-11022-1-1.html 


我 从 网 上 下 载 了 一 个 Struts 2、Spring 和 Hibernate 整合 项 目 ， 搭 建 了 开发 环境 ， 运 行 时 ， 
在 控制 台 输 出 “org.hibernate.id.IdentifierGenerationException ”异常 ， 不 知道 是 什么 意思 ， 该 如 
何 解决 ?紧急 求解 ! 

【解决 办 法 】: 出 现 这 个 异常 的 原因 是 : 你 的 实体 类 映射 文件 中 的 <id> 元 素 配 置 不 正确 ， 
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<id> 元 素 缺 少 其 子 元 素 <generator></generator> 的 配置 。 

<id> 元 素 映 射 了 相应 数据 库 表 的 主键 字段 ， 对 其 子 元 素 <generator class=""> 中 的 class 取 值 
可 以 为 increment、identity、sequence、hilo、native 等 ， 更 多 的 可 参考 hibemate 参考 文档 ， 
般 取 其 值 为 native 功能 是 适应 本 地 数据 库 。 


11.4 习 题 
一 、 填 空 题 
(1) 在 AOP 中 ， 通 知 分 为 前 置 通知 、 后 置 通知 、 通知 和 异常 通知 。 
(2) Hibernate 支持 两 种 主要 的 查询 方式 : 查询 和 Criteria 查询 。 
(3) 在 Hibernate 配置 文件 中 ，<set> 节 点 的 属性 描述 了 级 联 操作 的 规则 。 
(4) 在 SSH 中 ,使 用 框架 实现 数据 持久 化 。 
(5) 在 SSH 中， 使 用 框架 管理 依赖 关系 。 
二 、 选 择 题 
(1) 关于 Spring 对 Hibernate 的 支持 ， 下 面 说 法 错误 的 是 。( 单 选 ) 


CO) 


A. Spring 提供 基 类 完成 了 繁琐 的 异常 处 理 代码 

B. Spring 提供 基 类 完成 了 繁琐 的 事物 处 理 代码 

C. Spring 提供 的 基 类 对 查询 提供 良好 的 支持 

D. Spring 提供 的 基 类 需要 注入 sessionFactory 才能 正常 运行 
下 面 关 于 AOP 的 说 法 错误 的 是 。( 单 选 ) 

A. AOP 将 散落 在 系统 中 的 “方面 ”代码 集中 实现 

B.AOP 有 助 于 提高 系统 的 可 维护 性 

CAOP 已 经 表现 出 了 将 要 代替 面向 对 象 的 趋势 

D. AOP 是 一 种 设计 模式 ，Spring 提供 了 一 种 实现 


(3) 对 Stmuts 的 描述 ， 错 误 的 是 。( 单 选 ) 
A. Struts 基于 Servlet 技术 实现 
B. 使 用 Struts 时 不 能 同时 使 用 Hibernate 或 Spring， 也 不 能 在 页 面 使 用 EL 表达 式 
CStmuts 是 MVC 设计 模式 的 实现 
D.， Struts 是 一 个 半成品 ， 可 以 基于 它 构 建 自己 的 应 用 程序 
(4) 某 blog 系统 采用 三 层 结 构 组 织 程序 ， 访 问 数据 库 的 代码 和 定义 积分 规则 的 代码 分 别 
应 该 放 在 系统 的 。( 单 选 ) 
A. 数据 访问 层 和 表现 层 B. 持久 化 层 和 业务 逻辑 层 
C. 数据 访问 层 和 业务 逻辑 层 D. 持久 化 层 和 验证 层 
三 、 上 机 练习 


上 机 练习 : 添加 并 显示 员工 信息 列表 。 
要 求 : 该 项 目 首先 创建 一 个 Employee 实体 类 ,编写 该 类 的 映射 配置 信息 , 设计 DAO 层 的 
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EmployeeDAO 接口 ， 主 要 定义 添加 员工 方法 和 查询 员工 信息 方法 ， 并 实现 该 接口 。 接 下 来 设 
计 业 务 逻 辑 层 的 EmployeeService 接口 添加 员工 方法 和 查询 员工 信息 方法 ， 并 实现 该 接口 。 控 
制 器 层 定义 一 个 EmployeeAction 包含 添加 员工 和 查询 员工 信息 操作 .还 需要 设计 视图 层 add.jsp 
用 于 添加 员工 ，listjsp 用 于 显示 员工 信息 。 

执行 效果 如 图 11-11 和 图 11-12 所 示 。 


11-11 添加 员工 


[CS 
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11-12 ”显示 员工 信息 
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内 容 摘 要 : 

对 于 一 个 企业 级 的 应 用 而 言 ， 常 常 需要 生成 大 量 的 统计 图 表 ， 例 如 ， 饼 图 、 柱 状 图 等 。 生 
成 这 些 统计 图 通常 有 两 种 做 法 : 一 种 是 直接 使 用 Applet 作为 容器 来 显示 这 些 统计 图 , 一 种 是 临 
时 生成 统计 图 的 图 片 ， 并 在 HTML 页面 中 显示 出 这 些 图 片 。 这 两 种 的 实现 方式 都 存在 着 效率 
低下 、 需 要 大 量 处 理 底层 的 图 形 细节 等 问题 。 

有 了 JFreeChart 的 包装 , 就 可 以 无 须 开 发 者 自己 来 处 理 底层 的 图 形 细节 。 借助 于 JFreeChart 
的 帮助 ， 开 发 者 可 以 非常 便捷 地 开发 出 各 种 各 样 的 图 表 。 这些 图 表 包 括 : 饼 图 、 柱 状 图 (普通 
柱状 图 及 堆栈 柱状 图 )、 线 图 、 区 域 图、 分 布 图 、 混 合 图 、 甘 特 图 及 一 些 仪表 盘 等 。 大 部 分 企 
业 级 应 用 所 需要 的 统计 图 ，JFreeChart 基本 都 可 以 满足 。 

这 一 章 将 为 读者 介绍 使 用 下 reeChart 如 何 生成 饼 图 、 柱 状 图 、 折 线 图 、 时 间 顺 序 图 及 带 交 
互 功能 的 热点 统计 图 ， 并 详细 介绍 Struts 2 与 下 reeChart 整合 。 

学 习 目标 : 
熟练 使 用 JFreeChart 生成 饼 图 。 
熟练 使 用 JFreeChart 生成 饼 状 图 。 
熟练 使 用 JEFreeChart 生成 折线 图 。 
熟练 使 用 JEFreeChart 生成 时 间 顺 序 图 。 
熟练 使 用 JEFreeChart 生成 带 交互 功能 的 热点 统计 图 。 
掌握 Struts 2 与 JFreeChart 整合 。 
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12.1 初始 JFreeChart 


JFreeChart 是 完全 基于 Java 语言 的 开源 项 目 , 因 此 可 以 在 Java 开发 环境 中 使 用 下 reeChart， 
包括 Java 应 用 程序 ， 或 者 是 Java Web 应 用 都 没有 任何 问题 。 结 合 iText 项 目 ， 也 可 以 将 生成 
的 统计 图 表 输 出 到 PDF 文件 ; 结合 最 新 的 POI 项 目 ， 也 可 以 将 生成 的 统计 图 表 图 输出 到 Excel 
文档 。 这 一 节 将 为 读者 介绍 如 何 使 用 IFreeChart 开发 项 目 。 


9 
加 ， 视频 教学 ， 光盘 /videos/12/JFreeChart.avi BO 攻 度 : ;分钟 


12.1.1 基础 知识 


初始 JFreeChart 


JFreeChart 可 用 于 生成 各 种 各 样 的 统计 图 表 ， 只 要 开发 者 提供 符合 下 reeChart 所 需 格式 的 
数据 ， 下 reeChart 即 可 自动 生成 相应 的 统计 图 表 , 这 些 统计 图 表 既 可 以 直接 输出 生成 图 片 文件 ， 
也 可 被 导出 成 PDF 文档 。 


1. JFreeChart 的 下 载 和 安装 


使 用 JEFreeChart 来 生成 统计 图 表 , 必须 下 载 和 安装 JEreeChart 项 目 。 下载 和 安装 下 reeChart 
的 步骤 如 下 。 

(1) 登录 JEFreeChart 的 官方 下 载 站 点 : http://www.jfree.org/jfreechart/download.html， 下 载 
JFreeChart 的 最 新 版 本 。 本 书 使 用 的 版 本 是 下 reeChart 1.0.13，JFreeChart 依赖 于 另外 一 个 项 目 : 
JCommon; 同时 下 载 该 项 目的 最 新 版 本 : JCommon 1.0.16。 

下 载 正 reeChart 有 如 下 三 个 选项 。 

@ JFreeChart: 下 载 下 reeChart 项 目的 压缩 文件 。 

@ Documentation: 下 载 下 reeChart 的 API 文档 压缩 文件 。 

@ JCommon: 下 载 JCommon 项 目的 压缩 文件 。 

依次 下 载 三 个 选项 ， 这 三 个 选项 都 是 使 用 下 reeChart 项 目 所 需要 的 。 


JCommon 选项 可 以 不 用 下 载 ， 但 如 果 开 发 者 需要 查阅 JCommon 的 相关 资料 ， 例 
注意 如 查看 JCommon 项 目的 源 文 件 ， 则 应 该 下 载 该 选项 。 


(2) 下 载 上 面 的 三 个 选项 后 ， 会 得 到 三 个 压缩 文件 ，jfreechart-1.0.13.zip 文件 、jfreechart- 
1.0.13-javadocs.zip 文件 和 jcommon-1.0.16.zip 文件 。 其 中 jfreechart-1.0.13-javadocs.zip 文件 里 包 
含 了 JFreeChart 项 目的 API 文档 ， 与 其 他 项 目的 API 文档 完全 相似 ， 此 处 不 再 袭 述 。 

解压 缩 过 eechart-1.0.13.zip 文件 ， 得 到 如 图 12-1 所 示 的 文件 结构 。 

其 中 : 
ant: 该 文件 夹 下 存放 了 编译 下 reeChart 项 目的 build.xml 文件 。 

@ checkstyle: 该 文件 夹 下 存放 了 生成 JEreeChart 项 目 API 文档 的 样式 文件 。 
@ ”docfiles: 该 文件 夹 下 存放 了 生成 下 reeChart 项 目的 图 表 、 图 片 。 
@ experimental: 该 文件 夹 下 存放 的 是 下 reeChart 项 目的 实验 性 新 功能 的 源 代码 。 
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12-1 JFreeChart 项 目 文档 结构 


@ lib: 该 文件 夹 下 存放 的 是 正 reeChart 项 目的 二 进 制 类 库 ， 以 及 编译 和 运行 JEreeChart 
所 依赖 的 第 三 方 类 库 。 
@ source: 该 文件 夹 下 存放 的 是 下 reeChart 的 源 代码 。 
swt: 该 路 径 下 存放 的 是 JEFreeChart 提供 的 SWT(Java Standard Widger Toolkit，Java 
标准 工具 集 ) 支 持 的 源 代码 。 
@ tests: 该 路 径 下 存放 的 是 下 reeChart 项 目 单元 测试 的 测试 用 例文 件 。 
@ jfreechart-1.0.13-demo.jar: JFreeChart 的 演示 实例 ， 使 用 java-jar jfreechart-1.0.13- 
demo.jar 命令 可 以 运行 该 实例 ， 但 JEreeChart 不 提供 这 些 演示 实例 的 源 代码 。 
其 他 如 licence-LGPL.txt 和 README .txt 等 都 是 说 明 性 文档 。 
》 可 能 读者 会 感到 奇怪 ，JFreeChart 怎么 没有 提供 入 门 指南 ， 参考 手册 等 文档 呢 ? 因 
提示 | 为 下 reeChatrt 与 JasperReports 项 目的 策略 相似 ， 它 们 都 是 使 用 该 项 目 免费 ， 但 文 
档 需要 收费 的 ， 所 以 没有 提供 。 


(3) 将 lib 路 径 下 的 所 有 JAR 文件 复制 到 需要 使 用 下 reeChart 项 目 应 用 的 CLASSPATH 路 
径 下 。 如 果 是 Web 应 用 则 需要 使 用 JEreeChart 图 表 ， 即 将 lib 下 的 所 有 JAR 文件 复制 到 Web 
应 用 的 WEB-INF/lib 路 径 下 ， 如 果 编 译 和 运行 中 需要 使 用 JFreeChart 项 目 ， 则 还 应 该 将 lib 路 
径 下 的 jfreechart-1.0.13.jar 文件 添加 到 系统 的 CLASSPATH 环境 变量 中 ;如 果 使 用 ANT, 或 其 
他 IDE 工具 ， 则 无 须 添 加 环境 变量 。 

经 过 上 面 的 三 个 步骤 ， 则 可 完成 下 reeChart 的 安装 。 

2. JFreeChart 开 发 


经 过 上 面 为 使 用 下 reeChart 做 的 准备 工作 ， 不 难 发 现 通过 下 reeChart 开发 统计 表 其 实 非常 
简单 。 基 本 上 ， 按 如 下 步骤 ， 即 可 非常 简单 地 开发 出 各 种 统计 表 。 

(1) 提供 一 个 Dataset 实例 ， 该 实例 里 包含 了 创建 统计 图 表 的 数据 。 

$ 不同 的 统计 图 表 所 使 用 的 Dataset 实例 不 一 样 ， 例 如 ， 饼 图 使 用 PieDataset 实例 作 
提示 | 为 饼 图 数据 ; 柱状 图 则 采用 CategoryDataset 作为 柱状 图 数据 。 

(2) 使 用 ChartFactory 的 多 个 工厂 方法 createXxxChart0 来 创建 统计 图 表 , 统计 图 表 就 是 一 
个 JFreeChart 对 象 。 

(3) 得 到 了 JEreeChart 对 象 后 ， 可 以 调用 setTitle 来 修改 统计 图 表 的 标题 ， 或 者 调用 
getLegend() 方 法 来 获得 指定 索引 的 图 表 图 例 ， 取 得 图 例 对 象 后 即 可 修改 图 表 的 图 例 。 
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(4) 通过 JfreeChart 对 象 的 getPlot0 方 法 ， 即 可 获得 图 表 的 Plot 对 象 。 该 对 象 对 应 于 统计 
图 表 的 实际 图 表 部 分 ， 可 以 调用 Plot 对 象 的 方法 来 修改 图 表 中 的 各 种 显示 内 容 。 

按 上 面 的 四 个 步骤 进行 ， 即 可 快速 开发 出 各 种 简单 的 下 reeChart 图 表 。 

在 上 面 步骤 中 ， 共 涉及 JFreeChart 的 如 表 12-1 所 示 的 核心 API。 


表 12-1 JFreeChart 核 心 API 


过 描 述 
这 是 一 个 数据 集 对 象 ， 用 于 提供 显示 图 表 所 用 的 数据 。 对 于 不 同类 型 的 统计 图 表 ， 也 需 
要 使 用 不 同 的 Dataset 对 象 

ChartFactory 该 对 象 是 一 个 图 表 工 厂 类 ， 通 过 调用 该 工厂 类 的 不 同方 法 ， 即 可 生成 不 同 的 统计 图 表 
统计 图 表 对 象 , JFreeChart 由 如 下 三 个 部 分 组 成 : TextTitle( 标 题 )、LegendTitle( 图 例 标题 ) 
和 XxxPlot( 实 际 统计 图 ) 
实际 统计 图 表 对 象 ， 这 个 对 象 决定 了 实际 图 表 的 显示 样式 ， 创 建 该 对 象 时 需要 Axis、 
Renderer 及 数据 集 对 象 的 支持 

实际 统计 图 表 是 根据 XxxPlot 对 象 生成 的 ， 为 了 生成 XxxPlot 对 象 ， 还 需要 额外 的 Axis、 

Rendererer 的 支持 。 除 此 之 外 ， 如 果 和 希望 在 页 面 上 生成 带 交 互 功能 的 热点 图 表 ， 还 需要 用 到 
XxxURLGenerator 和 XxxToolTipGenerator 等 API。 即 JFreeChart 还 包含 如 表 12-2 所 示 的 常用 
的 核心 API。 


XxxDataset 


JFreeChart 


XxxPlot 


表 12-2 JFreeChart 核 心 API 


国 描 述 
XxxAxis 用 于 处 理 图 表 的 两 个 轴 : 纵 轴 和 横 轴 
XxxRenderer 负责 如 何 显示 一 个 图 表 对 象 
XxxURLGenerator 用 于 生成 Web 图 表 中 每 个 项 目的 超级 链接 
XxxToolTipGenerator 用 于 生成 图 表 的 帮助 提示 ， 不 同类 型 图 表 对 应 不 同类 型 的 工具 提示 类 


12.1.2 ”实例 描述 


JFreeChart 为 我 们 提供 了 生成 各 类 图 表 的 方便 ， 从 而 能 够 使 我 们 轻松 地 将 一 些 复杂 的 数据 
利用 图 表 的 方式 反馈 给 用 户 。 在 上 文中 已 经 向 大 家 详细 介绍 了 JEreeChart 的 安装 以 及 开发 的 方 
法 。 在 本 案例 中 ， 将 利用 一 个 “机 电 销 售 统计 图 ”应 用 实例 向 大 家 讲解 JEreeChart 在 实际 开发 
中 的 使 用 方法 。 


12.1.3 ”实例 应 用 


【 例 12-1】 使 用 下 reeChart 生成 “机 电 销 售 统计 图 ”。 
(1) 新 建 Web Project 项 目 ， 解 压 jfreechart-1.0.13.zip 压缩 包 ， 把 它 里 面 lib 文件 夹 下 的 
这 eechart1.0.13Jjar 文件 和 jcommon-1.0.16.jar 文件 引入 到 新 建 项 目的 WEB-INF/lib 下 。 
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(2) 在 项 目 中 创建 PieChartDemo.java 类 ， 这 个 类 用 于 生成 饼 状 图 。 代 码 如 下 。 


package com.struts2.jfreechart; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


java.awt.Font; 

java.io.FileOutputstream; 
java.io.IOException; 

org.jfree.chart .ChartFactory; 
org.jfree.chart .ChartUtilities; 
org.jfree.chart .JFreeChart; 
org.jfree.chart .plot .PiePlot; 
org.jfree.chart.title.LegendTitle; 
org.jfree.chart.title.TextTitle; 
org.jfree.data.general .DefaultPieDataset; 


class PieChartDemo { 


// 创 建 一 个 Dataset 对 象 ， 获 取 数 据 


private static DefaultPieDataset getDataSet ()1{ 


上’ 


DefaultPieDataset dataset=new DefaultPieDataset (); 
dataset .setValue ("联想 笔记 本 电脑 G450", 2000) 7 

dataset .setValue ("索尼 手机 ",1900); 

dataset .setValue ("诺基亚 手机 ", 1980); 

dataset .setValue ("戴尔 笔记 本 ", 1230); 

return dataset; 


public static void main(String[] args) throws IOException{ 


monte 


DefaultPieDataset dataset=getDataSet (); 
JFreeChart chart= 
ChartFactory.createPieChart( 

"机 电 销量 统计 图 ",// 图 表 标 题 

getDataSet () , // 数 据 

true, // 是 否 显示 图 例 

false, // 是 否 显示 工具 提示 

false// 是 否 生成 URL 


); 

// 重 新 设置 图 表 标 题 ， 改 变 字体 

chart.setTitle (new TextTitle ("机 电 销量 统计 图 ", new Font ("黑体 
ITALIC, 22))); 

// 取 得 统计 图 表 的 第 一 个 图 例 

LegendTitle legendTitle=chart .getLegend(0) 7 

// 修 改 图 例 的 字体 

legendTitle.setItemFont (new Font ("宋体 ", Font .BOLD,14)); 

// 获 得 饼 状 图 的 Plot 对 象 

PiePlot plot=(PiePlot)chart.getPlot(); 

// 设 置 饼 状 图 各 部 分 的 标签 字体 

plot.setLabelFont (new Font (" 隶 书 " :Font .BOLD, 18)); 

// 设 置 背景 透明 度 (0-1.0 之 间 ) 

plot.setBackgroundAlpha (0.9f); 

// 设 置 前 景 透 明度 

plot.setForegroundAlpha (0.5f); 


// 创 建 一 个 文件 输出 流 


< 作 —_ 
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FileOutputstream fos=new FileOutputstream("piechart.jpg"); 
// 使 用 chartutilities 将 图 表 输 出 到 文件 中 
ChartUtilities.writeChartAsJPEG( 

fos，// 输 出 到 哪个 输出 流 

1l1，//JPEG 图 片 的 质量 ，0-1 之 间 


chart, // 统 计 图 表 对 象 
800,// 宽 
600,// 高 


null//ChartRenderingInfo 信息 
) 
fos.close() 


} 

, 

上 面 代码 先 提供 一 个 方法 ， 该 方法 返回 Dataset 对 象 ， 这 个 Dataset 就 是 创建 统计 图 表 的 底 
层 数 据 ， 然 后 调用 ChartFactory 的 createPieChart 方法 来 生成 一 个 下 reeChart 对 象 ， 这 个 对 象 就 
是 统计 图 表 ， 该 图 表 可 以 直接 输出 到 图 片 文件 中 ， 也 可 导出 成 各 种 格式 的 文件 。 上 面 代 码 是 导 
出 了 一 个 JPG 格式 的 图 片 文件 。 

结合 上 面 代码 部 分 可 以 看 出 ， 修 改 统计 图 表 的 标题 部 分 (包括 修改 图 表 标 题 内容 、 字 体 大 
小 等 ) 都 是 通过 JEFreeChart 对 象 的 setTitle0 方 法 实现 的 ,修改 统计 图 表 的 图 例 则 通过 LegendTitle 
对 象 来 完成 。 一 个 统计 图 可 以 包含 多 个 图 例 ， 当 调用 JEreeChart 对 象 的 getLegend(int index) 方 
法 时 ， 就 可 以 取得 该 图 表 的 指定 索引 的 图 例 对 象 ， 一 旦 取得 了 指定 图 例 ， 就 可 以 修改 图 例 的 文 
本 内 容 、 字 体 大 小 等 。 


12.1.4 运行 结果 


运行 上 面 程序 ， 将 生成 一 个 piechart.jpg 文件 ， 使 用 Windows 图 片 和 传真 查看 器 浏览 该 图 
片 ， 将 看 到 如 图 12-2 所 示 的 饼 状 图 。 


图 12-2 ”使 用 JFreeChart 生 成 简单 饼 状 图 
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12.1.5 ”实例 分 析 


an 


通过 上 面 的 案例 ， 不 难 发 现 JFreeChart 的 使 用 非常 简单 ， 只 需要 提供 满足 JFreeChart 要 求 
的 数据 ， 即 可 使 用 JEreeChart 创建 一 个 JEFreeChart 图 表 ， 就 如 在 上 案例 中 调用 ChartFactory 的 
createPieChart 方法 ， 并 把 数据 作为 createPieChart 的 一 个 参数 提供 给 下 reeChart， 从 而 生成 一 张 
漂亮 的 饼 状 图 。 


12.2” JFreeChart 统计 图 表 一 一 柱状 图 


使 用 下 reeChart 生成 柱状 图 需要 使 用 CategoryDataset 作为 统计 图 表 的 数据 载体 , 生成 柱状 
图 后 依然 可 以 使 用 下 reeChart 来 设置 统计 图 表 的 标题 和 图 例 格 式 。 
这 一 节 将 为 读者 介绍 使 用 JFreeChart 如 何 生 成 柱状 图 。 


cc 视频 教学 : 光盘 /videos/12/JFreeChartExample.avi 生长 度 : 6 分钟 
12.2.1 基础 知识 使 用 JFreeChart 生 成 柱状 图 


JFreeChart 可 以 非常 方便 地 生成 各 种 形式 的 统计 图 表 ， 包 括 柱 状 图 。 柱 状 图 的 DataSet 
般 是 用 CatagoryDataset 接口 (具体 实现 类 是 DefaultCategoryDataset)， 有 时 也 会 用 
IntervalXYDataset 接口 。 获 取 柱 状 图 的 DataSet 对 象 代码 如 下 所 示 。 


DefaultCategoryDataset defaultcategorydataset = new 
DefaultCategoryDataset (); 


其 中 DefaultCategoryDataset 类 中 有 一 个 addValue0 方 法 ， 这 个 方法 有 如 下 三 个 参数 。 
@ double value: 数据 值 。 
@ javalang.Comparable rowKey: 横 轴 标签 内 容 。 
@ javalang.Comparable columnKey: 纵 轴 标签 内 容 。 
这 样 ， 就 可 以 为 正 reeChart 所 要 生成 的 柱状 图 创建 数据 源 了 ， 代 码 如 下 。 
private static CategoryDataset getDataset (){ 
DefaultCategoryDataset dataset=new DefaultCategoryDataset (); 
dataset .setValue (2000, "一 月 份 ", "联想 笔记 本 电脑 G450") ; 
dataset .setValue (1900, "一 月 份 ", "索尼 手机 "); 
dataset .setValue (1980, "一 月 份 ", "诺基亚 手机 "); 
dataset .setValue (1230, "一 月 份 ", "戴尔 笔记 本 ") ; 


return dataset; 
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JFreeChart 生成 的 统计 报表 图 有 了 数据 源 , 接 下 来 就 该 对 柱状 图 进行 以 下 设置 并 加 载 数据 。 
首先 使 用 ChartFactory 的 多 个 工厂 方法 createBarChart3D( 来 创建 图 表 ， 统 计 图 表 是 一 个 
JFreeChart 对 象 ， 如 下 面 代码 所 示 。 
JFreeChart chart=ChartFactory-createBarChart( 
"机 电 销 量 统计 图 "， // 图 表 标 题 
"各 种 电器 "， // 目 录 轴 的 显示 标签 
"销量 ",// 数 值 轴 的 显示 标签 
getDataset () ,// 数 据 集 
//Plotorientation.HORIZONTRL, // 图 表 方 向 : 水 平 
PlotOrientation.VERTICAL, // 图 表 方 向 : 水平 ,垂直 
false, // 是 否 显示 图 例 ， 对 于 简单 的 柱状 图 必须 是 false 
false, // 是 否 生成 工具 
false// 是 否 生成 URL 连接 
) 7 


得 到 下 reeChart 对 象 后 ， 可 以 调用 它 的 一 些 方法 设置 图 表 的 图 例 。 接 着 调用 JEFreeChart 的 
getPlot( 方 法 来 取得 实际 图 表 实 例 。 代 码 如 下 。 


CategoryPlot plot=(CategoryPlot)chart.getPlot(); 


既然 是 柱状 图 , 就 不 能 像 饼 状 图 那样 无 横 、 纵 轴 。 获取 柱状 图 的 横 轴 需要 调用 CategoryPlot 
类 中 的 getDomainAxis0 方 法 。 这 个 方法 得 到 的 是 一 个 CategoryAxis 类 对 象 ， 如 下 所 示 。 
// 获 取 横 轴 


CategoryAxis categoryAxis=plot.getDomainAxis(); 


获取 柱状 图 的 横 轴 后 ， 可 以 调用 CategoryAxis 的 setLableFont(java.awt.Font font) 方 法 来 设 
置 横 轴 显示 标签 的 字体 …… 

对 于 获取 柱状 图 的 纵 轴 则 需要 调用 CategoryPlot 类 的 getRangeAxis0 方 法 ， 这 个 方法 得 到 
的 是 一 个 NumberAxis 对 象 ， 如 下 所 示 。 


// 获 取 纵 轴 


NumberAxis numberAxis=(NumberAxis)plot.getRangeAxis(); 


在 NumberAxis 类 中 也 存在 setLabelFont(java.awt.Font font) 方 法 , 用 来 设置 纵 轴 显示 标签 的 
字体 。 

到 此 为 止 ， 对 柱状 图 的 图 例 格 式 就 设置 完毕 了 ， 最 后 将 统计 图 表 输 出 成 卫 G 文件 ! 代码 
如 下 。 


FileOutputstream fos=new FileOutputSstream("categoryChart.jpg"); 
// 将 柱状 图 表 输出 成 JPG 文件 
ChartUtilities.writeChartAsJPEG( 
fos, // 输 出 到 哪个 输出 流 
1，//jpeg 图 片 的 质量 
chart,// 统 计 图 表 对 象 
800,// 宽 
600,// 高 
null//ChartRenderingInfo 信息 
由 


fos.close(); 


mm >> 
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12.2.2 ”实例 描述 


我 那个 卖 机 电 的 朋友 事 真 多 , 今天 又 上 门 拜 访 我 ， 让 我 把 他 们 公司 各 个 产品 的 销售 金额 做 
成 一 张 柱状 图 的 图 片 。 真 是 烦 啊 ， 谁 让 我 答应 他 第 一 次 来 着 ， 让 他 抓 住 了 我 的 “小 把 柄 ”了 ， 
让 他 知道 我 会 用 代码 生成 一 张 他 想 要 的 图 片 了 ， 这 不 他 三 番 五 次 的 来 找 我 ， 我 算是 服 了 他 了 ， 
不 过 没 办 法 ， 谁 让 他 是 我 朋友 呢 。 

这 次 又 是 三 下 五 除 二 ， 不 费 吹 灰 之 力 帮 他 解决 了 这 个 难题 。 


12.2.3 ”实例 应 用 


【 例 12-2】 使 用 JFreeChart 生成 柱状 图 。 
在 项 目 中 创建 生成 柱状 图 的 类 BarChartDemo.java， 代 码 如 下 。 


package com.struts2.jfreechart; 


import java.awt.Font; 
import java.io.FileOutputstream; 
import java.io.IOException; 
import org.jfree.chart.ChartFactory; 
import org.jfree.chart.ChartUtilities; 
import org.jfree.chart.JFreeChart; 
import org.jfree.chart .axis.CategoryAxis; 
import org.jfree.chart.axis.CategoryLabelPositions; 
import org.jfree.chart.axis.NumberAxis; 
import org.jfree.chart.plot.CategoryPlot; 
import org.jfree.chart.plot.PlotOrientation; 
import org.jfree.chart.title.LegendTitle; 
import org.jfree.chart.title.TextTitle; 
import org.jfree.data.category.CategoryDataset; 
import org.jfree.data.category.DefaultCategoryDataset; 
public class BarChartDemo { 
private static CategoryDataset CreateDataset () 
{ 
String seriesl = "January"; 
String series2 = "February"; 
String series3 = "March"; 
String categoryl "联想 笔记 本 电脑 6450"; 
string category2 = "索尼 手机 "; 
String category3 = "诺基亚 手机 "; 
String category4 = "戴尔 笔记 本 "; 
String category5 = "松下 血压 仪 "; 
DefaultCategoryDataset defaultcategorydataset = new 


ll 


DefaultCategoryDataset (); 
defaultcategorydataset.addValue (2000D, seriesl, categoryl1); 
defaultcategorydataset.addValue (4000D, seriesl, category2); 
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defaultcategorydataset.addValue (3000D, seriesl, category3); 
defaultcategorydataset.addValue (5000D, seriesl, category4); 
defaultcategorydataset .addValue (5120D, seriesl, category5); 
defaultcategorydataset .addValue (5441D, series2, categoryl1); 
defaultcategorydataset .addValue (7111D, series2, category2); 
defaultcategorydataset .addValue (6000D, series2, category3); 
defaultcategorydataset .addValue (8200D, series2, category4); 
defaultcategorydataset .addValue (4000D, series2, category5); 
defaultcategorydataset .addValue (4125D, series3, categoryl1); 
defaultcategorydataset .addValue (3411D, series3, category2); 
defaultcategorydataset .addValue (2141D, series3, category3); 
defaultcategorydataset .addValue (3541D, series3, category4); 
defaultcategorydataset .addValue (6000D, series3, category5); 
return defaultcategorydataset; 


} 
public static void main(String[] args) throws IOException{ 
JFreeChart jfreechart = ChartFactory.createBarChart( 
"机 电 销量 统计 图 "， // 图 形 标题 名 称 
"销量 ", // 目 录 横 轴 的 显示 标签 
"总 额 "，// 数 值 轴 的 显示 标签 
createDataset (), // dataset 
Plotorientation.VERTICRL，// 垂 直 显 示 
true，// 显示 图 例 
true，// 生成 工具 
false) ; // 不 要 生成 URL 连接 
// 重 新 设置 图 表 标 题 ， 改 变 字体 
jfreechart.setTitle (new TextTitle ("机 电 销 售 统计 图 ", new Font ("黑体 
",Font.ITALIC, 22))); 
// 取 得 统计 图 表 的 第 一 个 图 例 
LegendTitle legendTitle=jfreechart.getLegend(0); 
// 修 改 图 例 的 字体 
legendTitle.setItemFont (new Font ("宋体 "， Font .BOLD,14)); 
CategoryPlot plot=(CategoryPlot)jfreechart .getPlot (); 
// 取 得 横 轴 
CategoryAxis categoryAxis=plot.getDomainAxis(); 
// 设 置 横 轴 显示 标签 的 字体 
categoryAxis.setLabelFont (new Font ("宋体 ", Font .BOLD, 22)); 


// 分 类 标签 以 45 度 角 倾斜 


CategoryAxis.setCategoryLabelPositions (CategoryLabelPositions.UP 45); 
categoryAxis.setTickLabelFont (new Font ("宋体 ", Font .BOLD, 18)); 
// 取 得 纵 轴 
NumberAxis numberAxis=(NumberAxis)plot.getRangeAxis(); 
// 设 置 纵 轴 显 示 标签 的 字体 
numberAxis.setLabelFont (new Font ("宋体 ", Font .BOLD, 22)); 
// 创 建 一 个 文件 输出 流 
FileOutputstream fos=new FileOutputstream("barchart.jpg"); 


// 使 用 chartUtilities 将 图 表 输 出 到 文件 中 
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ChartUtilities.writeChartAsJPEG( 


fos，// 输 出 到 哪个 输出 流 
1，//JPEG 图 片 的 质量 ，0-1 之 间 
jfreechart, // 统 计 图 表 对 象 
800,// 宽 

600,// 高 


null//ChartRenderingInfo 信息 
) 


fos.close(); 


} 


在 上 面 的 代码 中 ,为 了 修改 柱状 图 坐标 轴 的 显示 格式 ,我 们 使 用 了 两 个 XxxAxis 实例 ， 其 
中 CategoryAxis 代表 柱状 图 的 横 轴 ， NumberAxis 代表 柱状 图 的 纵 轴 。 分 别 调用 CategoryPlot 
的 如 下 两 个 方法 ， 即 可 获得 柱状 图 的 横 轴 和 纵 轴 。 

@ ”getDomainAxis: 返回 柱状 图 的 横 轴 。 

@ ”getRangeAxis: 返回 柱状 图 的 纵 轴 。 


12.2.4 运行 结果 


运行 BarChartDemo 类 , 在 本 项 目的 根 路 径 下 生成 一 张 名 为 barchartjpg 的 统计 图 ,如 图 12-3 
所 示 。 
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12-3 ”使 用 JFreeChart 生 成 柱状 图 
12.2.5 ”实例 分 析 


Cn 


在 上 案例 中 ,我们 创建 了 CategoryDataset 实例 ， 该 实例 调用 addValue( 方 法 时 ， 传 入 了 三 
个 参数 ， 其 中 第 二 个 参数 是 一 组 数据 的 key。 因 为 该 程序 使 用 了 不 同 的 key， 所 以 程序 在 统计 
图 表 中 使 用 了 图 例 ， 并 且 修改 了 图 例 的 格式 。 


< 
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12.3 JFreeChart 统计 图 表 一 一 折线 图 


对 于 数据 的 变化 、 发 展 情况 或 发 展 趋势 可 以 使 用 折线 图 来 描述 ， 其 显示 方式 非常 直观 。 本 
节 将 为 读者 讲解 一 下 使 用 下 reeChart 组 件 如 何 生成 折线 图 。 


4 
是 视频 教学 : 光盘 /videos/12/JFreeChartExample.avi 侈 长 度 : 6 分 钟 


12.3.1 基础 知识 使 用 JFreeChart 生 成 折线 图 


因为 折线 图 和 柱状 图 的 图 形 结构 大 致 相似 ， 区 别 在 于 柱状 图 使 用 立方 体 (或 者 矩形 ) 表 示 数 
值 ， 而 折线 图 则 采用 固定 值 表示 数值 。 因 此 ， 生 成 折线 图 与 生成 柱状 图 的 过 程 大 致 相似 ， 同 样 
可 以 采用 CategoryDataset 实例 作为 统计 图 表 的 数据 。 

按照 下 reeChart 的 开发 步骤 第 二 步 ， 有 了 数据 源 ， 就 可 以 使 用 ChartFactory 的 多 个 工程 方 
法 createXxxChart 来 创建 统计 图 表 ， 折 线 图 调用 了 ChartFactory 的 createLineChart3D 这 个 方法 
来 创建 JEreeChart 对 象 。 如 下 面 代码 所 示 。 

JFreeChart chart = ChartFactory.createLineCchart3D( 

"2004-2010 年 优秀 杀毒 软件 杀毒 数量 统计 ", / /图 表 标题 
"杀毒 软件 ", //X 轴 标 题 

" 查 杀 病毒 数量 ", //Y 轴 标题 

createDataSet () ,// 绘 图 数据 集 ， 调 用 了 获取 数据 源 的 方法 
Blotorientation.VERTICRAL,// 绘 制 方向 
true，// 显 示 图 例 

true，// 采 用 标准 生成 器 

false// 是 否 生成 超 链接 

) 站 

前 面 一 节 讲 到 的 使 用 IFreeChart 生成 柱状 图 代码 中 ， 获 取 绘 图 区 对 象 ， 即 CategorypLot 对 
象 采 用 的 方法 是 调用 JEFreeChart 的 getPlot0 方 法 。 从 下 reeChart 的 API 文档 中 可 以 看 出 ， 
JFreeChart 类 中 存在 两 个 方法 : getPlot0 和 getCategoryPlot0。 其 中 ， 前 者 返回 的 是 一 个 Plot 对 
象 ， 它 是 CategoryPlot0 类 的 父 类 ， 后 者 返回 的 直接 就 是 一 个 CategoryPlot 对 象 。 因 此 可 以 直接 
调用 下 reeChart 类 中 的 getCategoryPlot0 方 法 来 获取 绘图 区 对 象 ， 即 


CategoryPlot plot = chart.getCategoryPlot () 7 


获取 绘图 区 对 象 后 ， 可 以 调用 它 的 一 些 方法 来 对 绘图 区 进行 美化 ， 比 如 设置 背景 色 、 水 平 
方向 背景 线 颜 色 、 垂 直方 向 背景 线 颜色 、 横 轴 字 体 颜 色 和 内 容 等 。 把 绘图 区 域 绘制 好 之 后 ， 来 
对 生成 的 折线 图 进行 一 下 设置 。 首 先 需要 获取 折线 图 对 象 ， 即 


LineAndshapeRenderer renderer = (LineAndshapeRenderer) 


plot.getRenderer (); 


折线 图 有 虚线 也 有 实 线 ， 设 置 虚线 的 代码 如 下 所 示 。 
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float dashes[] = { 8.0f };// 定 义 虚 线 数组 
Basicstroke brokenLine = new BasicStroke(1.6f，/ 线 条 粗细 
Basicstroke.CAP_SQUARE，// 端 点 风格 
Basicstroke.JOIN MITER，// 折 点 风格 
8.f, // 折 点 处 理 办 法 
dashes，// 虚 线 数组 
0.0f// 虚 线 偏 移 量 
JR 
设置 实 线 代 码 为 。 
Basicstroke realLine = new Basicstroke (1.6f); // 设 置 实 线 


设置 折线 图 使 用 实 线 绘 制 还 是 虚线 绘制 ， 需 要 调用 LineAndShapeRenderer 类 的 setSeries 
Stroke(int series,java.awt.Stroke stroke) 方 法 。 

这 个 方法 有 两 个 参数 ， 第 一 个 参数 表示 要 绘制 的 第 几 条 线 ， 是 一 个 以 1 开头 的 int 类 型 的 
数字 ; 第 二 个 参数 是 一 个 java.awt.Stroke 对 象 , 表示 该 条 线 是 要 用 实现 绘制 还 是 要 用 虚线 绘制 。 
如 下 面 代码 ， 表 示 第 一 条 线 用 虚线 绘制 。 


renderer.setSeriesstroke(l, brokenLine); 


最 后 使 用 ChartUtilities 将 图 表 输 出 到 文件 中 ， 生 成 一 张 图 片 。 到 此 ， 使 用 下 reeChart 生成 
折线 图 就 完成 了 。 


12.3.2 ”实例 描述 


我 们 经 理 真是 天 天 没事 干 睹 折腾, 这 几 天 他 又 想 知道 他 电脑 上 的 杀毒 软件 在 最 近 几 年 的 杀 
毒 情 况 。 我 需要 声明 一 下 啊 ， 他 的 电脑 已 经 有 10 年 的 寿命 了 ， 并 且 电 脑 上 的 杀毒 软件 更 是 多 
得 数不胜数 ， 也 许 这 就 是 他 的 电脑 能 “ 活 ” 到 现在 的 最 贴切 的 原因 吧 ! 

我 们 经 理 比 较 “ 器 重 ” 我 ， 就 让 我 接 了 这 活 。 

还 好 ， 我 的 技术 是 经 得 起 考验 的 。 下 面 案例 就 是 使 用 折线 图 对 2004 一 2010 年 杀毒 软件 杀 
毒 数 量 进行 统计 ， 其 显示 效果 分 为 普通 样式 和 3D 样式。 本 实例 数据 集合 的 数据 随机 产生 ， 故 
每 次 显示 的 结果 并 非 一致 。 


12.3.3 ”实例 应 用 


【 例 12-3】 使 用 折线 图 统计 2004 一 2010 年 优秀 杀毒 软件 的 杀毒 情况 。 
在 本 章 的 项 目 中 继续 创建 XYLineChart 类 ， 用 于 生成 折线 图 。 内 容 如 下 。 


package com.struts2.jfreechart; 
import java.awt.BasicSstroke; 
import java.awt.Color; 

import java.awt.Font; 

import java.io.FileOutputstream; 
import java.io.IOException; 
import java.util.Random; 
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import org.jfree.chart.ChartFactory; 

import org.jfree.chart.ChartUtilities; 

import org.jfree.chart.JFreeChart; 

import org.jfree.chart.plot.CategoryPlot; 

import org.jfree.chart.plot.PlotOrientation; 

import org.jfree.chart.renderer.category.LineAndShapeRenderer; 
import org.jfree.data.category.CategoryDataset; 

import org.jfree.data.category.DefaultCategoryDataset; 


public class XYLineChart { 


// 字体 
private static final Font PLOT FONT = new Font ("宋体 ",，Font.BOLD, 15); 
/*# 
* 创建 数据 集合 
* @return CategoryDataset 对 象 
2 
public static CategoryDataset createDataSet () { 
// 图 例 名 称 
String[] line = { "杀毒 软件 一 "， "杀毒 软件 二 "， "杀毒 软件 三 ”] 7 
// 类 别 


String[] category = { "2004 年 "，"2005 年 "，"2006 年 "，"2007 年 "，"2008 
年 ", "2009 年 ", "2010 年 "”}; 

Random random = new Random();// 实例 化 Random 对 象 
// 实例 化 DefaultcategoryDataset 对 象 
DefaultCategoryDataset dataSet = new DefaultCategoryDataset (); 
// 使 用 循环 向 数据 集合 中 添加 数据 
for (int i = 0; i < line.length; i++) { 

for (int j = 0; j < category.length; j++) { 

dataset .addValue (100000 + random.nextInt (100000), line[i], 
category[j]); 


下 
return dataSet7 
} 
/** 
* 生成 制图 对 象 
和 
* Q@param is3D 是 否 为 3D 效果 
* @return JFreeChart 对 象 
*x 
public static void main (String[] args) throws IOException{ 


java.util.Scanner input = new java.util.Scanner(System.in); 
System.out.print ("是 要 3D 效果 吗 ? (true/false): "); 
String is3D = input.next(); 


JFreeChart chart = null; 
if(is3D.equals ("true")){ 
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chart = ChartFactory.createLineChart3D( 

"2004-2010 年 优秀 杀毒 软件 杀毒 数量 统计 ", / /图 表 标 题 

"杀毒 软件 ", / /x 轴 标 题 

" 查 杀 病毒 数量 ", //Y 轴 标 题 

createDataSet () ,// 绘 图 数据 集 

PlotOrientation.VERTICAL, // 绘 制 方向 

true, // 显 示 图 例 

truev // 采 用 标准 生成 器 

false// 是 否 生成 超 链接 

}elsef{f 
chart = ChartFactory.createLineChart( 

"2004-2010 年 优秀 杀毒 软件 杀毒 数量 统计 "， / /图 表 标题 
"杀毒 软件 ", //X 轴 标 题 
" 查 杀 病毒 数量 ", / /Y 轴 标 题 


CreateDataSet (), 


// 绘 图 数据 集 

PlotOrientation.VERTICAL, // 绘 制 方向 

true, // 是 否 显示 图 例 

true, // 是 否 采 用 标准 生成 器 

false// 是 否 生成 超 链接 

站 

} 

// 设 置 标题 字体 
chart .getTitle () .setFont (new Font ("隶书 "，Font .BOLD，23) ) ; 
// 设 置 图 例 类 别 字 体 


chart.getLegend() .setItemFont (new Font (" 宋 体 "，Eont .BOLD，15) ) ; 
chart .setBackgroundPaint (new Color(192,228,106));  // 设 置 背 景色 
// 获 取 绘 图 区 对 象 
CategoryPlot plot = chart.getCategoryPlot () 7 
plot .getDomainaxis () .setLabelFont (PLOT_FONT) ;// 设 置 横 轴 字体 
plot .getDomainAxis() .setTickLabelFont (PLOT_FONT) ;// 设 置 坐标 轴 标尺 值 字体 
plot .getRangeRxis () .setLabelFont (PLOT_FONT) ;// 设 置 纵 轴 字 体 
plot.setBackgroundPaint (Color .WHITE) ;// 设 置 绘图 区 背景 色 
plot.setRangeGridlinePaint (Color .RED) ;// 设 置 水 平方 向 背景 线 颜 色 
plot.setRangeGridlinesVisible (true);// 设 置 是 否 显示 水 平方 向 背景 线 , 默认 值 为 
true 
plot.setDomainGridlinePaint (Color .RED);// 设 置 垂直 方向 背景 线 颜色 
plot .setDomainGridlinesVisible(true);// 设 置 是 否 显示 垂直 方向 背景 线 , 默认 值 
为 false 
// 获 取 折 线 对 象 
LineandShapeRenderer renderer = (LineAndSshapeRenderer) 
plot.getRenderer (); 

Basicstroke realLine = new Basicstroke (1.6f);// 设 置 实 线 
float dashes[] = { 8.0f };// 定 义 虚线 数组 
Basicstroke brokenLine = new Basicstroke (1.6f,// 线 条 粗细 

Basicstroke .CAP_SQUARE, // 端 点 风格 

BasicStroke-JOIN_ MITER, // 折 点 风格 

8-E，// 折 点 处 理 办 法 
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dashes，// 虚 线 数组 
0.0f/ /虚线 偏 移 量 
Ms 
renderer.setSeriesSstroke (1，brokenLine);// 利 用 虚线 绘制 
renderer.setSeriesstroke (2，brokenLine);// 利 用 虚线 绘制 
renderer.setSeriesstroke (3，realLine);// 利 用 实 线 绘制 
// 创 建 一 个 文件 输出 流 
FileOutputstream fos=new FileOutputstream("linechart.jpg"); 
// 使 用 chartutilities 将 图 表 输出 到 文件 中 
ChartUtilities.writeChartAsJPEG( 
fos，// 输 出 到 哪个 输出 流 
1，//JPEG 图 片 的 质量 ，0-1 之 间 
chart, // 统 计 图 表 对 象 
800,// 宽 
600,// 高 
null//chartRenderingInfo 信息 
); 
fos.close(); 


和 
其 中 ，createDataSet0 方 法 用 于 创建 数据 集合 对 象 。 实 例 中 使 用 JDK 中 的 Random 类 所 产 


生 的 随机 数据 进行 填充 。 它 返回 CategoryDataSet 对 象 。 程 序 的 入 口 函数 中 要 求 从 控制 台 输 入 
-个 Boolean 值 ， 根 据 输入 的 值 来 判断 生成 普通 样式 折线 图 还 是 3D 样式 折线 图 效果 。 


12.3.4 ”运行 结果 


运行 程序 ， 控 制 台 输 出 如 下 。 

是 要 3D 效果 吗 ? (true/false): 

在 控制 台中 输入 true, 打开 本 项 目的 根 目录 , 生成 一 张 名 为 linechartjpg 的 图 片 , 如 图 12-4 
所 示 。 

再 次 运行 程序 ， 当 控制 台 出 现 “是 要 3D 效果 吗 ? (true/falsej: ”时 ， 在 其 后 面 输入 false， 
生成 普通 样式 折线 图 ， 如 图 12-5 所 示 。 


图 12-4 3D 样 式 折 线 图 12-5 普通 样式 折线 图 


mt >> 
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12.3.5 ”实例 分 析 


Cn 


上 案例 中 ， 在 程序 的 主 函 数 中 要 求 输入 一 个 Boolean 值 ， 来 判断 生成 的 折线 图 效果 是 3D 
样式 还 是 普通 样式 。 从 代码 的 角度 来 看 ， 不 管 是 3D 样式 还 是 普通 样式 并 没有 太 大 的 区 别 ， 只 
有 一 点 区 别 ， 就 是 调用 ChartFactory 类 的 createLineChart3D() 方 法 生成 的 是 3D 样式 ， 而 调用 它 
的 createLineChart() 方 法 生成 的 就 是 普通 样式 ， 其 他 在 设置 折线 图 的 其 他 特性 上 都 是 相同 的 。 


12.4 JFreeChart 统 计 图 表 时 间 顺 序 图 


时 间 顺 序 图 可 用 于 统计 、 分 析 数 据 随 时 间 变 化 的 发 展 情况 。 它 的 创建 需要 用 到 XYDataset 
数据 集合 。 本 节 介 绍 使 用 下 reeChart 如 何 生成 时 间 顺 序 图 。 


PP) 
一 视频 教学 : 光盘 /videos/ 12/JFreeChartExample.avi 全 长 度 : 6 分 钟 


12.4.1 基础 知识 使 用 JFreeChart 生 成 时 间 顺 序 图 


时 间 顺 序 图 与 上 面 的 折线 图 非常 相似 ， 但 区 别 在 于 时 间 顺 序 图 不 可 使 用 3D 图 形 ， 且 时 间 
顺序 图 的 水 平 坐标 轴 是 时 间 。 

生成 时 间 顺 序 图 需要 使 用 XYDataset 实例 作为 统计 图 的 底层 数据 。XYDataset 有 一 个 实现 
类 : TimeSeriesCollection。 

这 个 时 间 序 列 实例 是 由 多 个 TimeSeries 对 象 组 成 的 , 每 个 TimeSeries 包含 多 个 时 间 点 的 统 
计 值 。 通 过 TimeSeriesCollection 将 多 个 TimeSeries 对 象 组 合 起 来 ， 就 可 以 生成 所 需要 的 时 间 
顺序 图 。 
使 用 下 reeChart 来 生成 时 间 顺 序 图 ， 与 生成 其 他 统计 图 并 没有 太 大 的 差别 ， 只 是 生成 时 间 
顺序 图 要 求 使 用 XYDataset 作为 底层 数据 , 故 使 用 TimeSeriesCollection 来 组 合 多 个 TimeSeries 
实例 ， 如 下 面 代 码 所 示 。 

Private static XYDataset getDataset ()1{ 

// 创 建 第 一 个 Timeseries 实例 

TimeSeries tsl=new TimeSeries (" 杀 毒 软 件 一 ") ; 
// 为 第 一 个 Timeseries 添加 不 同时 间 点 的 统计 值 
tsl.add (new Month(10,2009),3400); 

/* 可 以 填充 更 多 时 间 点 的 统计 值 */ 

/ /创建 第 二 个 Timeseries 实例 

TimeSeries ts2=new TimeSeries ("杀毒 软件 二 "); 
// 为 第 二 个 Timeseries 添加 不 同时 间 点 的 统计 值 
ts2.add (new Month (10, 2009)，2800) > 
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/* 可 以 填充 更 多 时 间 点 的 统计 值 */ 
// 创 建 Timeseriescollection 实例 
TimeSeriesCollection datasetCollection=new TimeSeriesCollection(); 
// 使 用 Timeseriescollection 来 组 合 多 个 Timeseries 实例 
datasetCollection.addSeries (ts1); 
datasetCollection.addSeries (ts2); 
return datasetCollection; 
} 
该 TimeSeriesCollection 就 是 一 个 XYDataset 实例 。 接 下 来 使 用 ChartFactory 类 中 的 create 
TimeSeriesChart() 方 法 创建 统计 图 表 ， 即 如 下 代码 。 
JFreeChart chart=ChartFactory.createTimeSeriesChart( 
"2004-2010 年 优秀 杀毒 软件 杀毒 数量 统计 "，/ /图 表 标题 
"杀毒 软件 ", / /x 轴 标 题 
" 查 杀 病毒 数量 ", / /Y 轴 标 题 
getDataset () , // 绘 图 数据 集 
true, // 显 示 图 例 
true, // 采 用 标准 生成 器 
false// 是 否 生成 超 链接 
) 7 
获取 了 统计 图 表 实 例 ， 可 以 调用 它 的 一 些 方法 对 生成 的 时 间 顺 序 图 进行 一 些 勾勒 ， 和 前 面 
所 讲 到 的 使 用 下 reeChart 生成 的 统计 图 表 代码 大 同 小 异 ， 这 里 不 再 累 袭 。 值 得 注意 的 是 ， 取 得 
时 间 顺 序 图 的 Plot 对 象 时 需要 调用 下 reeChart 类 中 的 getXYPlot0 方 法 ， 即 如 下 代码 。 


XYPlot plot=chart .getXYPlot (); 


12.4.2 ”实例 描述 


今天 闲 来 无 事 ， 就 看 一 本 《Java 基础 教程 》 的 书 ， 这 本 书 的 销售 额 之 高 令 人 惊 呼 。 好 奇 心 
的 我 很 想 知道 这 本 书 今 年 的 销售 量 是 什么 样 的 情况 ? 当然 , 我 也 不 知道 这 本 书 在 每 个 月 的 销售 
数量 达到 多 少 ， 数 据 只 能 是 随机 生成 。 

本 实例 中 ， 使 用 TimeSeries 对 象 填充 10 个 月 的 数据 ， 然 后 通过 时 序 图 统计 书 的 销售 量 。 
本 实例 数据 并 非 是 真实 数据 ， 是 随机 而 生 ， 因 此 每 次 显示 结果 并 非 一 致 。 


12.4.3 ”实例 应 用 


【 例 12-4】 通过 时 序 图 统计 书 的 销售 量 。 
在 本 章 项 目 中 创建 自 定义 制图 工具 类 ChartUtil, 在 此 类 中 编写 两 个 方法 , 分别 用 于 创建 数 
据 集合 及 生成 时 间 顺 序 图 。 其 关键 代码 如 下 。 
public class ChartUtil { 
// 字 体 


Private static final Font PLOT_FONT = new Font (" 黑 体 "，Font.ITRALIC , 18); 


// 返 回 一 个 xYDataset 实例 
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private static XYDataset getDataset ()1{ 


// 实 例 化 TimeSeries 对 象 

TimeSeries timeseries = new TimeSeries ("Data") 7 

Day day = new Day(l, 1, 2010); // 实 例 化 Day 

double d = 3000D; // 添 加 一 年 365 天 的 数据 

For int 4 = 07 1 < 305 HT 
d= d+ (Math.random() - 0.5) * 10; // 创 建 随机 数据 
timeseries.add(day, d); // 向 数据 集合 中 添加 数据 


day = (Day) day.next(); 
} 
// 创 建 TimeseriesCcollection 集合 对 象 
TimeSeriesCollection timeSeriesCollection =new 
TimeSeriesCollection (timeseries); 
// 返 回 数据 集合 对 象 
return timeSeriesCollection; 
3. 
public static void main(String[] args) throws IOException{ 


// 创 建 时 序 图 对 象 
JFreeChart chart = ChartFactory.createTimeSeriesChart!( 

"Java 基础 全 国 销量 统计 "， // 标 题 

"销售 月 份 "， // 时 间 轴 标签 

"销量 (本 ) "， // 数 据 轴 标签 

getDataset (), / /数据 集合 

false, // 是 否 显示 图 例 标识 

false, // 是 否 显示 tooltips 

false); // 是 否 支持 超 链接 
// 设 置 标题 字体 
Chart.getTitle() .setFont (new Font (" 隶 书 "， Font .BOLD, 26)); 
// 设 置 背 景色 
chart.setBackgroundPaint (new Color(252,175,134)); 
XYPlot plot = chart.getXYPlot (); // 获 取 图 表 的 绘制 属性 
plot.setDomainGridlinesVisible (false); // 设 置 网 格 不 显示 
// 获 取 时 间 轴 对 象 
DateAxis dateAxis = (DateAxis) plot.getDomainAxis(); 
dateAxis.setLabelFont (PLOT_ FONT); // 设 置 时 间 轴 字体 
// 设 置 时 间 轴 标尺 值 字体 
dateAxis.setTickLabelFont (new Font ("宋体 "， Font .PLAIN,12)); 
dateAxis.setLowerMargin(0.0); // 设 置 时 间 轴 上 显示 的 最 小 值 
// 获 取 数 据 轴 对 象 
ValueAxis valueAxis = plot.getRangeAxis(); 
valueAxis.setLabelFont (PLOT_FONT); // 设 置 数据 字体 
DateFormat format = new SimpleDateFormat ("MM 月 份 ") ; // 创 建 日 期 格式 对 象 
// 创 建 DateTickUnit 对 象 
DateTickUnit dtu = new DateTickUnit (DateTickUnitType.DAY,29,format); 
dateAxis.setTickUnit (dtu); // 设 置 日 期 轴 的 日 期 标签 


// 创 建 一 个 文件 输出 流 


FileOutputstream fos=new FileOutputstream("timeSeries.jpg"); 


// 使 用 chartutilities 将 图 表 输出 到 文件 中 


ChartUtilities.writeChartAsJPEG( 


fos, // 输 出 到 哪个 输出 流 
I //JPEG 图 片 的 质量 ，0-1 之 间 
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chart, // 统 计 图 表 对 象 

800, // 宽 

600, // 高 

null //chartRenderingInfo 信息 


); 
fos.close(); 
} 

此 类 中 属性 PLOT_FONT 是 一 个 静态 的 字体 常量 对 象 , 使 用 此 对 象 可 以 避免 反复 用 到 的 字 
体 对 象 被 多 次 创建 。 

getDataset() 方 法 用 于 创建 数据 集合 对 象 。 时 间 顺 序 图 的 数据 集合 与 其 他 数据 集合 不 同 ， 它 
需要 添加 一 个 时 间 段 内 的 所 有 数据 ， 通 常 采用 TimeSeries 类 进行 添加 。 由 于 数据 量 较 大 ， 实 例 
中 通过 Math 类 的 random0 方 法 进行 随机 生成 。 

程序 的 主 函数 用 于 创建 制图 对 象 ， 它 返回 JEreeChart 对 象 。 由 于 时 间 顺 序 图 属于 坐标 轴 类 
型 的 图 表 ， 实 例 中 通过 日 期 轴 对 象 DateAxis 与 时 间 轴 对 象 ValueAxis 对 相关 属性 进行 设置 。 


12.4.4 运行 结果 
字 ， 


运行 程序 ， 生 成 一 张 名 为 timeSeries.jpg 的 图 片 ， 如 图 12-6 所 示 。 


图 12-6 ”使 用 JFreeChart 生 成 时 间 顺 序 图 


12.4.5 ”实例 分 析 


ee 


通过 上 面 的 案例 ， 不 难 发 现 : 使 用 JEreeChart 来 生成 各 种 统计 图 表 是 相当 简单 的 事情 ， 只 
要 按 前 面 所 指示 的 步骤 ， 即 可 生成 各 种 统计 图 表 。 在 生成 不 同 的 统计 图 表 的 过 程 中 ， 关 键 差别 
在 于 需要 使 用 不 同 的 Dataset 作为 底层 数据 源 。 


>> 
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12.5 在 网 页 中 生成 带 交 互 功能 的 统计 图 


很 多 时 候 ， 需 要 直接 在 JSP 页 面 中 生成 统计 图 表 。 当 需要 在 JSP 页 面 中 生成 统计 图 表 时 ， 
常用 的 做 法 就 是 提供 系列 的 自 定义 标签 。 自 定义 标签 封装 了 JFreeChart 的 统计 图 功能 ， 从 而 简 
化 JEFreeChart 的 开发 。 
除 此 之 外 ， 还 可 以 利用 网 页 图 片 的 热点 功能 ， 生 成 带 交 互 功能 的 统计 图 。 本 节 将 为 读者 介 
绍 如 何 使 用 下 reeChatrt 在 网 页 中 生成 带 交 互 功能 的 统计 图 。 


9 
视频 教学 光盘 /videos/12/JFreeChartExample.avi 国度 : 6 分 名 


12.5.1 基础 知识 一 一 在 网 页 中 生成 带 交互 功能 的 统计 图 


生成 带 交 互 功能 的 统计 图 需要 使 用 正 reeChart 项 目的 三 个 核心 API, 分 别 是 XxxToolTipGenerator、 
XxxURLGenerator 和 ChartRendererInfo， 关 于 它们 的 功能 简介 如 下 。 
@ XxxToolTipGenerator: 用 于 生成 图 表 的 帮助 提示 ， 当 鼠标 在 统计 图 的 各 部 分 悬 停 时 ， 
@ XxxURLGenerator: 用 户 生 成 Web 图 表 中 每 个 项 目的 超级 连接 。 
@ ChartRendererInfo: 该 对 象 封装 了 统计 图 表 显 示 的 相关 信息 。 
繁多 的 理论 知识 不 如 来 了 实例 “吸收 ”的 快 。 下 面 就 以 一 段 代码 来 演示 一 下 如 何 运用 上 面 
三 个 核心 API 在 网 页 中 生成 带 交 互 功能 的 统计 图 。 
// 创 建 3D 饼 图 的 Plot 对 象 
PiePlot3D plot3D=new PiePlot3D(dataset) 7 
// 生 成 3D 饼 图 的 图 表 
JFreeChart chart=new 
JFreeChart ("",JFreeChart .DEFAULT TITLE FONT,plot3D,true); 
// 生 成 饼 图 各 部 分 的 提示 ， 当 鼠标 悬 停 时 显示 实际 统计 值 
plot3D.setToolTipGenerator (new StandardPieToolTipGenerator()); 
// 设 定 热点 链接 
plot3D.setURLGenerator (new StandardPieURLGenerator ("piechart.jsp")); 
StandardEntityCollection entityCollection=new 
StandardEntityCollection(); 
// 生 成 RenderingInfo 实例 
ChartRenderingInfo info=new ChartRenderingInfo(entityCollection); 
// 在 Web 服务 器 的 临时 目录 生成 一 张 图 片 ，800 是 图 片 长 度 ，600 是 图 片 高 度 
// 将 图 表 的 热点 信息 在 HTML 页 面 中 输出 , pw 代表 页 面 的 输出 流 , map 是 定义 热点 的 Map 标签 ID 
//info 参数 就 是 图 片 的 热点 信息 


ChartUtilities.writeImageMap (pwPrintWriter, "map", info, false); 


在 上 面 代码 中 使 用 了 一 个 ServletUtilities 类 ， 这 个 类 与 前 面 介绍 的 ChartUtilities 功能 大 致 
相似 ， 都 用 于 输出 各 种 格式 的 图 片 文件 。 它 们 区 别 在 于 ChartUtilities 通常 用 于 直接 将 报表 图 片 
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输出 到 指定 图 片 文件 中 ,但 ServletUtilities 则 将 报表 图 片 输出 到 Web 服务 器 的 临时 目录 下 ， 并 
且 无 需 指定 图 片 文件 的 文件 名 ， 而 是 由 系统 自动 生成 该 图 片 文件 的 文件 名 。 

上 面 的 代码 可 以 生成 一 张 统计 图 表 ， 这 张 统计 图 表 图 片 被 放 在 了 Web 服务 器 的 临时 目录 
下 。 为 了 提供 更 好 的 解 簿 ， 让 Web 应 用 与 不 同 的 Web 服务 器 解 厢 ，JFreeChart 提供 了 一 个 名 
为 “DisplayChart” 的 Servlet， 这 个 Servlet 专门 用 于 显示 不 同 Web 服务 器 的 临时 目录 下 的 统计 
图 片 。 


5 在 Web 应 用 中 使 用 JEFreeChart 项 目 时 ， 应 该 使 用 ServletUtilities 来 生成 统计 图 片 ， 
给 示 | 。 ServletUtilities 工具 类 会 自动 将 统计 图 片 放 入 Web 服务 器 的 临时 目录 下 ,然后 通过 
DisplayChart 工具 Servlet 来 显示 Web 服务 器 临时 目录 下 的 指定 图 片 。 


为 了 使 用 DisplayChart Servlet 来 显示 Web 服务 器 临时 目录 下 的 图 片 ， 应 该 在 Web 应 用 的 
web.xml 文件 中 配置 DisplayChart Servlet， 因 此 应 该 在 web.xml 文件 中 增加 如 下 片段 。 
<servlet> 
<servlet-name>DisplayChart</servlet-name> 
<servlet-class>org.jfree.chart.servlet.DisplayChart</servlet-class> 
</servlet> 
<servlet-mapping> 
<servlet-name>DisplayChart</servlet-name> 
<url-pattern>/DisplayChart</url-pattern> 
</servlet-mapping> 
在 JSP 页 面 中 使 用 DisplayChart 来 显示 Web 服务 器 端 临 时 目录 下 的 统计 图 片 , 即 带 热点 交 
互 功能 的 <img .…/>HTML 标签 代码 如 下 所 示 。 


<img src="DisplayChart” width="720" height="450" usemap="#map"> 


$ usemap 完全 是 一 个 HTML 标签 属性 ， 它 用 于 将 HTML 页 面 上 的 图 片 划分 出 几 个 
提示 | ”区 域 ， 每 个 区 域 对 应 一 个 热点 ， 每 个 热点 可 单独 指定 一 个 超级 链接 。 


在 浏览 器 中 浏览 该 JSP 页 面 后 ， 表 面 上 看 起 来 与 前 面 介绍 的 3D 饼 图 并 没有 太 大 的 差别 。 
但 当 把 鼠标 移动 到 饼 图 的 任何 一 个 部 分 时 ， 可 看 到 光标 变 成 手 的 形状 。 这 表明 该 图 片 的 这 个 部 
分 包含 了 热点 链接 。 在 左下 角 的 地 址 栏 中 ， 也 可 以 看 到 该 链接 的 URL 信息 。 实 际 上 ， 该 链接 
的 URL 中 包含 了 光标 所 在 饼 图 部 分 的 信息 。 

上 面 代码 使 用 下 reeChart 核心 API 中 的 XxxURLGenerator() 方 法 , 指定 了 所 要 对 应 的 URL 
为 piechartjsp 页 面 ， 这 就 是 该 统计 图 上 热点 链接 的 地 址 。 

如 此 编写 代码 ， 当 点 击 饼 图 中 的 任何 部 分 时 都 会 链接 到 piechartjsp 页 面 ， 从 而 实现 在 页 面 
中 生成 带 交 互 功能 的 统计 图 。 


12.5.2 ”实例 描述 
从 一 张 统计 图 上 只 能 看 出 该 产品 的 销售 量 在 总 销售 量 中 所 占 的 比例 , 但 无 法 比较 该 产品 的 


销售 量 在 本 类 产品 总 销售 量 中 所 占 的 比例 。 上 次 为 我 朋友 做 的 销量 统计 图 只 能 实现 宏观 的 观看 
某 产品 在 总 销售 量 中 所 占 的 比例 ， 朋 友 公司 老总 很 是 不 满 ， 这 次 又 让 我 给 他 改动 一 下 ， 改 成 在 


mt >> 
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网 页 上 生成 饼 状 统计 图 , 并 点 击 某 一 部 分 时 要 跳 转 至 该 产品 的 销售 量 在 该 类 产品 的 总 销售 量 中 
所 占 比例 的 统计 图 页 面 。 哈 哈 - -名 优秀 的 开发 者 是 经 得 起 “ 风 吹 雨 打 ” 的 。 


12.5.3 ”实例 应 用 


【 例 12-5】 使 用 下 reeChart 在 网 页 中 生成 带 交 互 功能 的 “机 电 销 量 统计 图 ”。 
(1) 在 WebRoot 下 创建 生成 带 热 点 交互 功能 的 统计 图 的 JSP 页 面 ， 内 容 片 段 如 下 。 


<%@ page contentType="text/html;charset=GBK"%> 

<%@ page import="org.jfree.data.general.DefaultPieDataset"$%> 
<%@ page import="org.jfree.chart.*"%> 

<%@ page import="org.jfree.chart.plot.*"$%> 

<%@ page import="org.jfree.chart.servlet.ServletUtilities"%®> 


<%@ page org.jfree.chart.urls.StandardPieURLGenerator"%®> 
<%@ page org.jfree.chart.entity.StandardEntityCollection"®> 
<%@ page java.io.*,java.awt.*"%> 

<%@ page org-.jfree-.chart-labelss*"%> 

<%@ page org-jfree chart-title>*"%> 

< 和 


/ /创建 饼 图 所 需 的 DefaultPieDateset 数据 

DefaultPieDataset dataset=new DefaultPieDataset (); 

dataset .setValue ("联想 笔记 本 电脑 6450", 2000); 

dataset .setValue (" 索 尼 手 机 ",1900) 7 

dataset .setValue (" 诺 基 亚 手机 ",1980) ; 

dataset.setValue (" 戴 尔 笔记 本 ",1230) ; 

// 创 建 3D 饼 图 的 Plot 对 象 

PiePlot3D plot3D=new PiePlot3D(dataset); 

plot3D.setLabelFont (new Font ("隶书 ", Font .BOLD,16)); 

// 生 成 3D 饼 图 的 图 表 

JFreeChart chart=new 
JFreeChart ("", JFreeChart .DEFAULT_ TITLE FONT,plot3D,true); 

// 重 新 设置 图 表 标 题 ， 改 变 字体 

chart.setTitle (new TextTitle ("机 电 销 量 统计 图 ", new Font ("黑体 
,Font.ITALIC, 22))); 

// 获 取 统计 图 表 的 图 例 对 象 

LegendTitle legendTit1le=chart .getLegend(0) 7 

// 修 改 图 例 的 字体 

legendTitle.setItemFont (new Font ("宋体 ", Font .BOLD,13)); 

// 生 成 饼 图 各 部 分 的 提示 ， 当 鼠标 悬 停 时 显示 实际 统计 值 

Plot3D.setToolTipGenerator (new StandardPieToolTipGenerator()); 

// 设 定 热点 链接 

plot3D.setURLGenerator (new StandardPieURLGenerator ("piechart .jsp")); 

StandardEntityCollection entityCollection=new 
StandardEntityCollection(); 

// 生 成 RenderingInfo 实例 


ChartRenderingInfo info=new ChartRenderingInfo(entityCollection); 


// 创 建 一 个 文件 输出 流 
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// 将 页 面 输出 流 out 包装 成 一 个 Printwriter 实例 

PrintWriter pwPrintWriter=new PrintWriter (out) 7 

// 在 web 服务 器 的 临时 目录 生成 一 张 图 片 ，800 是 图 片 长 度 ，600 是 图 片 高 度 

String filename=ServletUtilities.saveChartAsPNG (chart, 800, 600, 
info,null); 

// 将 图 表 的 热点 信息 在 HTML 页 面 中 输出 , pw 代表 页 面 的 输出 流 , map 是 定义 热点 的 Map 标签 ID 

//info 参数 就 是 图 片 的 热点 信息 

ChartUtilities.writeImageMap (pwPrintWriter, "map", info, false); 
%> 


(2) 在 项 目的 web.xml 文件 中 配置 DisplayChart Servlet。 前 面 已 经 讲 过 ， 这 里 不 再 详 述 。 

(3) 在 使 用 DisplayChart 显示 Web 服务 器 临时 目录 下 的 统计 图 片 时 ， 需 要 传 入 一 个 
filename 的 参数 。 因 此 ， 如 果 需 要 使 用 DisplayChart 来 显示 临时 目录 下 的 统计 图 片 ， 则 应 该 指 
定 一 个 filename 参数 , 即 在 第 一 步 中 创建 的 生成 带 热点 交互 功能 的 统计 图 表 JSP 页 面 中 加 入 如 
下 代码 。 


<img src="DisplayChart?filename=<$%g=filenameg>"” width="720" height="450" 
usemap="#map"> 


(4) 从 上 面 的 代码 中 可 以 看 出 ,该 统计 图 指定 的 URLGenerator 对 应 的 URL 为 piechart.jsp 
页 面 。 这 个 页 面 将 读 取 该 统计 图 发 送 的 请 求 参 数 ， 并 根据 不 同 链接 显示 不 同 的 统计 图 。 
piechart.jsp 页 面 的 Java 脚本 代码 如 下 。 


<%@ page contentType="text/html;charset=GBK"%> 
<%@ page import="org.jfree.chart.ChartFactory, org.jfree.chart.JFreeChart, 
org.jfree.chart.plot.PlotOrientation" $%> 
<%@ page 
import="org.jfree.chart.servlet.ServletUtilities,org.jfree.data.category.*" 
%> 
<%@ page import="org.jfree.chart.title.*"%> 
<%@ page import="org.jfree.chart.plot.*"%> 
<%@ page import="org.jfree.chart.axis.*"%®> 
<%@ page import="java.awt.*"%> 
< 多 

CategoryDataset dataset; 

// 取 得 地 址 栏 里 的 查询 字符 串 

String queryString = request.getQuerystring(); 

// 将 地 址 栏 里 的 查询 字符 串 解码 成 正确 的 编码 形式 

querystring = java.net.URLDecoder.decode (querySstring, "UTF-8"); 

System.out .println (querystring); 

String category = null; 

// 取 出 查询 字符 串 的 请 求 参 数 

for (String param : querySstring.split("g")) { 

String[] nameValue = param.split ("="); 
category = nameValue[0] .equals ("category") ? nameValue[1] 
: Category; 

. 

String subTitle = ""; 

// 根 据 传 过 来 的 不 同 的 请 求 参数 决定 dataset 值 ， 以 及 subTitle 的 字符 串 值 

if (category-equals (" 联 想 笔记 本 电脑 5450") 11 category.equals ("戴尔 
笔记 本 ")) { 
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dataset = leeGetDataset (); 
subTitle = "电脑 "; 

} else { 
dataset = getDataSet () 7 
subTitle = "手机 "; 


} 

// 定 义 统计 图 的 标题 

String title = subTitle + "机 电 销 量 统计 图 "; 
// 生 成 一 个 统计 图 实例 


JFreeChart chart = ChartFactory.createBarChart3D (title, "月 份 "," 


dataset, PlotOrientation.VERTICAL, true, false, 
// 重 新 设置 图 标 标题 ， 改 变 字 体 
chart .setTitle (new TextTitle ("机 电 销 量 统计 图 " 


Font .ITALIC, 


22))); 
// 取 得 统计 图 标的 第 一 个 图 例 
LegendTitle legend = chart.getLegend(0); 
// 修 改 图 例 的 字体 
legend.setItemFont (new Font ("宋体 "， Font .BOLD, 14)); 
CategoryPlot plot = (CategoryPlot) chart.getPlot(); 
// 取 得 横 轴 
CategoryAxis categoryAxis = plot.getDomainAxis(); 


// 设 置 横 轴 显示 标签 的 字体 


false); 


+: new Font ("黑体 "， 


categoryAxis.setLabelFont (new Font ("宋体 "，Font.BOLD, 22)); 


// 分 类 标签 以 45 度 角 倾斜 


categoryAxis 


.SetCategoryLabelPositions (CategoryLabelPositions.UP 45); 
categoryAxis.setTickLabelFont (new Font ("宋体 "，Font.BOLD, 18)); 


$%> 


// 取 得 纵 轴 


NumberAxis numberAxis = (NumberAxis) plot.getRangeAxis(); 


// 设 置 纵 轴 显 示 标签 的 字体 


numberAxis.setLabelFont (new Font ("宋体 "，Font.BOLD, 22)); 


String filename = ServletUtilities.saveChartAsPNG (chart, 650, 390, 


null, session); 


<%1// 单 击 电脑 类 的 产品 销售 量 时 ， 要 生成 的 统计 图 的 数据 源 
private static CategoryDataset leeGetDataset() { 
DefaultCategoryDataset dataset = new DefaultCategoryDataset (); 
dataset .addValue (3000， "联想 笔记 本 电脑 6450"， "09 年 10 月 "); 
dataset-addValue (2800， "联想 笔记 本 电脑 6450"， "09 年 11 月 "); 
dataset .addValue (2100， "联想 笔记 本 电脑 6450"， "09 年 12 月 "); 
dataset-addValue (3200， "联想 笔记 本 电脑 6450"， "10 年 01 月 "); 
dataset .addValue (2800，" 惠 普 电 脑 "， "10 年 01 月 ") 
dataset .addValue (2680，" 惠 普 电 脑 "， "10 年 02 月 ") 
dataset .addValue (2690， "联想 笔记 本 电脑 5450"， "10 年 02 月 "); 
dataset.addValue (1830， "戴尔 笔记 本 "，"10 年 02 月 ") 
dataset .addValue (3490， "惠普 电脑 "， "10 年 03 月"); 
dataset-addValue (1890， "联想 笔记 本 电脑 6450"， "10 年 03 月 "); 
dataset .addVvalue (2640， "戴尔 笔记 本 "，"10 年 03 月 ") 


< 
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dataset-addValue (3180，" 惠 普 电脑 "， "10 年 04 月 "); 
Teturn dataset; 


} 

// 单 击 手机 类 的 产品 时 ， 要 生成 的 统计 图 的 数据 源 

private static CategoryDataset getDataset() { 
DefaultCategoryDataset dataset = new DefaultCategoryDataset (); 
dataset .addVvalue (3500,，" 诺 基 亚 手机 "，"09 年 10 月 "); 
dataset .adqdValue (4200,，" 索 尼 手 机 "，"09 年 10 月 "); 
dataset.adqValue (3800， "诺基亚 手机 "，"09 年 11 月 "); 
dataset .adqdValue (2300,，" 索 尼 手 机 "，"09 年 11 月 "); 
dataset .adqValue (2590，" 诺 基 亚 手机 "，"09 年 12 月 "); 
dataset .addValue (1590，" 索 尼 手 机 "，"09 年 12 月 "); 
dataset-addValue (3180， "诺基亚 手机 "，"10 年 01 月 ") 7 
dataset.addValue (1200，" 索 尼 手 机 "，"10 年 01 月 "); 
dataset .addValue (3140， "诺基亚 手机 "，"10 年 02 月 ") 7 
dataset-addValue(940，" 索 尼 手 机 "，"10 年 02 月 ") ; 
return dataset; 

}%> 


(5) 从 上 面 的 piechartjsp 页 面 代码 中 可 以 看 出 : 本 页 面 与 前 面 一 个 页 面 类 似 的 是 ， 本 页 面 
- 样 使 用 了 ServletUtilities 将 统计 图 导出 到 Web 服务 器 的 临时 目录 下 , 因此 在 JSP 页 面 中 也 需 
要 使 用 DisplayChart 来 显示 该 统计 图 。 下 面 是 JSP 页 面 中 显示 该 统计 图 的 <img .…./>HTML 标签 
代码 。 
<img Src="DisplayChart?filename=<%=filenameg>"” width="650" height="390" 
border="0" /> 


12.5.4 运行 结果 


在 浏览 器 中 浏览 上 面 创建 的 第 一 个 页 面 , 即 在 网 页 中 生成 带 交 互 功能 的 机 电 销 量 统计 图 页 
面 ， 将 看 到 如 图 12-7 所 示 的 页 面 。 


12-7 ”生成 带 交互 功能 的 统计 图 
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如 果 我 们 在 上 图 12-7 所 示 的 页 面 中 单 击 “ 联 想 笔 记 本 G450” 和 “戴尔 笔记 本 ”中 任意 一 
个 部 分 ， 即 可 看 到 如 图 12-8 所 示 的 柱状 统计 图 。 

如 果 单 击 上 图 12-7 所 示 的 页 面 中 的 “诺基亚 手机 ”和 “索尼 手机 ”的 任意 一 个 部 分 时 ， 
即 可 看 到 如 图 12-9 所 示 的 柱状 统计 图 。 
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图 12-8 使 用 热点 交互 功能 生成 柱状 图 12-9 使 用 热点 交互 功能 生成 柱状 图 


12.5.5 “实例 分 析 


Cs 


在 上 案例 中 , 对 于 piechartjsp 页 面 而 言 , 它 是 完全 自由 的 , 可 以 非常 灵活 地 输出 任意 内 容 ， 
既 可 以 再 次 生成 统计 图 表 来 显示 处 理 结 果 ， 也 可 以 使 用 文本 内 容 来 输出 处 理 结果 。 通 过 这 种 方 
式 ， 可 以 实现 非常 灵活 的 用 户 交互 功能 。 


12.6 在 Struts 2 应 用 中 使 用 JFreeChart 
将 下 reeChart 与 Strmuts 2 整合 后 ， 对 下 reeChart 统计 图 表 的 开发 有 一 定 的 简化 作用 。 本 节 
将 为 读者 介绍 如 何在 Struts 2 中 使 用 FreeChart 统计 图 表 。 
NN 视频 教学 : 光盘 /videos/12/JFreeChartExample.avi 国 长 度 : 6 分 钟 
12.6.1 ”基础 知识 一 一 在 Struts 2 应 用 中 使 用 JFreeChart 
Strmts 2 是 一 个 Java EE 应 用 的 Web 层 解决 方案 ， 将 底层 数据 以 各 种 形式 显示 出 来 也 是 其 


主要 任务 。 结 合 JEFreeChart 项 目 后 ，Struts 2 可 以 直接 以 JEFreeChart 图 表 作 为 表现 层 组 件 ， 直 接 
使 用 下 reeChart 图 表 来 显示 Action 的 处 理 结果 。 


< 二 一 
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1. 安装 JFreeChart 插 件 


为 了 在 Struts 2 中 使 用 下 reeChart 统计 图 表 ，Struts 2 提供 了 JEreeChart 插件 支持 。 借 助 于 
JEFreeChart 插件 的 支持 ，Struts 2 可 以 非常 方便 地 使 用 JEreeChart 统计 图 表 。 

JFreeChart 插件 的 主要 作用 就 是 在 页 面 中 显示 Action 中 的 JEreeChart 对 象 。 实 际 上 ， 
JFreeChatrt 插件 所 完成 的 工作 非常 有 限 。 即 使 在 Struts 2 中 整合 了 JFreeChart 框架 ， 依 然 需要 手 
动 创建 下 reeChart 实例 ， 这 是 非常 繁琐 的 事情 。 最 理想 的 状况 就 是 只 提供 需要 显示 的 数据 ， 而 
Struts 2 对 JEFreeChart 进行 封装 ， 自 动 生成 下 reeChart 图 表 ， 并 将 其 显示 在 HTML 页 面 上 。 


Struts 2 对 JEFreeChart 的 封装 非常 有 限 ， 即 使 使 用 Struts 2 整合 下 reeChart， 依 然 需 


得 未 | ”要 在 Action 中 手动 创建 JFreeChart 实例 ， 这 点 让 人 感到 非常 麻烦 。 

与 Struts 2 的 其 他 插件 类 似 ， 安 装 下 reeChart 插件 非常 容易 ， 只 需 将 Struts 2 的 JEreeChart 
插件 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 即 可 。 

在 研究 Struts 2 的 下 reeChart 时 ， 发 现 下 reeChart 插件 与 JasperReports 插件 有 一 个 相同 的 
问题 : 查看 struts2-jfreechart-plugin-2.1.8.1.jar 文件 中 的 struts-plugin.xml 文件 时 ， 发 现 该 配置 文 
件 中 代码 如 下 。 

<?xml] Version="1.0"” encoding="UTF-8" ?> 

<!DOCTYPE struts PUBLIC 

"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 


"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 


Tm 


<package name="jfreechart-default" extends="struts-default"> 
<result-types> 
<result-type name="chart" 
class="org.apache.struts2.dispatcher.ChartResult"> 
<param name="height">150</param> 
<param name="width">200</param> 
</result-type> 
</result-types> 
</package> 
</struts> 


从 该 文件 中 看 出 ，JFreeChart 插件 的 主要 作用 就 是 定义 了 一 个 名 为 chart 的 Result 类 型 。 
JFreeChart 插件 定义 的 包 是 从 struts-default 扩展 而 来 , 这 样 就 可 以 以 简单 的 方式 在 Struts 2 应 用 
中 使 用 下 reeChatrt 统计 图 表 了 。 

除了 要 将 上 面 的 struts2-jfreechart-plugin-2.1.8.1.jar 文件 复制 到 Web 应 用 的 WEB-INF/lib 路 
径 下 之 外 。 还 需要 将 下 reeChart 的 二 进 制 类 库 文件 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 。 

经 过 上 面 的 步骤 ， 即 完成 了 Struts 2 和 JFreeChart 的 整合 。 

2. JFreeChart 在 Struts 2 中 的 使 用 


正如 前 面 介绍 的 ， 使 用 Struts 2 整合 JEFreeChart 后 ， 对 开发 JFreeChart 并 没有 提供 太 多 的 
简便 ， 依 然 需要 手动 创建 下 reeChart 实例 。 
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1) 创建 Action 

如 果 需 要 的 Action 中 的 统计 图 表 能 被 Struts 2 处 理 ， 则 要 求 该 下 reeChart 类 型 的 属性 名 为 
chart。 在 Struts 2 的 Action 中 创建 生成 统计 图 表 的 下 reeChart 实例 ， 需 要 在 Action 中 定义 一 个 
返回 JEreeChart 对 象 的 方法 ， 即 代码 如 下 。 


public class JFreeChartAction extends RctionSupport { 
// 用 于 输出 统计 图 表 的 属性 必须 是 chart 
private JFreeChart chart; 
// 返 回 JFreechart 统计 图 表 的 getter 方法 
public JFreeChart getChart() { 
/* 生 成 统计 图 表 的 代码 ， 和 前 面 使 用 JFreechart 生成 的 统计 图 表 代码 并 无 二 样 */ 
} 
; 


上 面 Action 类 继承 ActionSupport 类 ,因此 无 需 提供 execute0 方 法 ,该 方法 返回 一 个 success 
字符 串 作 为 逻辑 视图 , 该 Action 直接 使 用 ActionSupport 的 execute() 方 法 作为 系统 的 处 理 罗 辑 。 
从 上 面 的 代码 中 不 难 发 现 ， 上 面 的 Action 有 如 下 两 个 非常 不 灵活 的 地 方 。 

@ ”需要 手动 创建 下 reeChart 实例 ， 与 创建 普通 JEreeChart 图 表 没有 太 大 的 区 别 。 

@ Action 的 统计 图 表 属 性 名 必须 是 chart, 这 种 硬 编码 方式 提供 的 属性 大 大 降低 了 Action 

的 灵活 性 。 


$ JEFreeChart 插件 要 求 用 户 的 Action 中 JEreeChart 类 型 的 属性 名 只 能 是 chart， 这 种 
注意 硬 编码 方式 提供 的 统计 图 表 大 大 降低 了 Action 的 灵活 性 。 
2) 配置 Action 
配置 正 reeChart 的 Action 非常 简单 ， 只 需要 为 该 Action 指定 一 个 类 型 为 chart 的 Result。 
该 Result 将 使 用 JFreeChart 统计 图 表 来 作为 视图 组 件 。 配 置 类 型 为 chart 的 Result 时 ， 可 以 指 
定 两 个 参数 : width 和 height， 这 两 个 参数 分 别 指定 统计 图 的 宽 和 高 。 
因为 前 面 已 经 定义 了 名 为 jfreechart-default 的 包 ， 该 包 扩 展 了 Struts 2 系统 的 struts-default 
包 ， 在 struts-default 包 里 增加 了 一 个 名 为 chart 的 Result 类 型 ， 因 此 应 该 在 Struts 2 应 用 中 自 定 
义 包 继 承 jfreechart-default 包 即 可 。 如 下 配置 所 示 。 


<!-- 配置 包 , 继承 jfreechart-default 包 --> 
<package name="jfreechart" namespace="/jfreechart"™" 
extends="jfreechart-default"> 
<!-- 定义 一 个 名 为 jfreechart 的 Action--> 
<action name="jfreeChart" 
class="com.struts2.actions.JFreeChartAction"> 
<result type="chart"> 
<!-- 定义 JFreeChart 报表 的 大 小 --> 
<param name="width">800</param> 
<param name="height">600</param> 
</resnlt> 
</action> 


</package> 


< 寺 —— 
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上 面 配 置 文件 配置 了 一 个 名 为 过 eeChart 的 Action。 该 Action 将 产生 一 个 类 型 为 chart 的 


Result。jfreeChart 的 Action， 即 可 生成 统计 图 。 


12.6.2 ”实例 描述 


为 了 给 读者 讲 清楚 JFreeChart 在 Struts 2 中 的 应 用 ， 我 把 前 面 为 朋友 公司 做 的 销售 情况 统 
计 图 改编 成 使 用 Struts 2 与 JEreeChart 整合 的 应 用 。 这 样 ， 在 他 们 公司 的 后 


以 查看 这 个 应 用 了 ， 而 不 需要 生成 一 张 图 片 。 


12.6.3 ”实例 应 用 


【 例 12-6】 在 Struts 2 应 用 中 使 用 JFreeChart 生成 “机 电 销 售 统计 图 ”。 
(1) 将 struts2-jfreechart-plugin-2.1.8.1jar 文件 和 Struts 2 相关 的 六 个 文件 一 同 引入 程序 的 


WEB-INF/lib 下 。 


(2) 在 com.struts2.actions 包 下 新 建 下 reeChartAction 类 ,定义 统计 图 表 属 性 名 为 chart， 并 


编写 生成 统计 图 的 方法 。JFreeChartAction 类 内 容 如 下 。 


package com.struts2.actions; 


import 
import 
import 
import 
import 
import 
import 
import 
public 


java.awt.Font; 


org. 
org. 
org. 
org. 
org. 
org. 
com. 
class JFreeChartAction extends ActionSupport 


jfree. 
jfree. 
jfree. 
jfree. 
jfree. 
jfree. 


chart.ChartFactory; 
chart.JFreeChart; 

chart .plot.PiePlot3D; 
chart.title.LegendTitle; 
chart.title.TextTitle; 
data.general .DefaultPieDataset; 


opensymphony .xwork2.Actionsupport; 


// 用 于 输出 统计 图 表 的 属性 必须 是 chart 
private JFreeChart chart; 

// 返 回 JFreechart 统计 图 表 的 getter 方法 
public JFreeChart getChart () { 
chart=ChartFactory.createPieChart3D( 
"机 电 销 量 统计 图 "， // 图 表 标题 
getDataset () ，// 数 据 
true，// 是 否 显 示 图 例 

false, // 是 否 显示 工具 提示 
false// 是 否 生成 URL 

1 

// 重 新 设置 图 表 标 题 ， 改 变 字体 


chart -setTitle (new TextTitle(" 机 电 销量 统 计 图 ",new Font ("黑体 


ur EFOnt. ETALIC, 22)) ) > 
// 取 得 统计 图 表 的 第 一 个 图 例 


LegendTitle legendTitle=chart.getLegend(0); 


// 改 变 图 例 的 字体 


legendTitle.setItemFont (new Font ("宋体 ", Font.BOLD,14)); 


// 获 得 饼 图 的 Plot 对 象 


台 管 理 系统 中 就 可 
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PiePlot3D plot3D= (PiePlot3D) chart .getPlot (); 
// 设 置 饼 图 各 部 分 的 标签 字体 
plot3D.setLabelFont (new Font ("隶书 ", Font .BOLD,18)); 
// 设 定 背 景 透明 度 (0-1 .0 之 间 ) 
plot3D.setBackgroundAlpha (0.9f); 
// 设 定 前 景 透明 度 (0-1 .0 之 间 ) 
plot3D.setForegroundAlpha (0.5f); 
return chart; 

} 

// 返 回 饼 图 的 底层 Dataset 的 工具 方法 

private DefaultPieDataset getDataset (){ 
DefaultPieDataset dataset=new DefaultPieDataset (); 
dataset .setValue ("联想 笔记 本 电脑 G450", 2000); 
dataset .setValue ("索尼 手机 ",1900); 
dataset .setValue ("诺基亚 手机 ",1980); 
dataset .setVvalue ("戴尔 笔记 本 ", 1230); 
return dataset; 


} 


(3) 在 Stmts 2 配置 文件 (struts.xml) 中 配置 该 Action， 需 要 配置 类 型 为 char 的 Result。 


struts.xml 文件 内 容 如 下 。 


<?xml] version="1.0" encoding="UTF-8" ?> 
<!-- 指定 拦截 器 的 DTD 信息 --> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<!-- 通过 常量 配置 struts2 所 使 用 的 解码 集 --> 
<constant name="struts.il8n.encoding" value="gbk" /> 
<constant name="struts.devMode" value="true" /> 
<!-- 配置 包 , 继承 jfreechart-default 包 --> 
<package name="jfreechart" namespace="/jfreechart" 
extends="jfreechart-default"> 
<!-- 定义 一 个 名 为 jfreechart 的 Action--> 
<action name="jfreeChart" 
class="com.struts2.actions.JFreeChartAction"> 
<result type="chart"> 
<!-- 定义 JFreeCchart 报表 的 大 小 --> 
<param name="width">800</param> 
<param name="height">600</param> 
</result> 
</action> 
</package> 
</struts> 


(4) 在 WEB-INF 目录 下 的 web.xml 文件 中 配置 Struts 2 控制 器 
码 如 下 。 


FilterDispatcher 类 。 代 


< 
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<filter> 
<filter-name>struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-cl 
ass> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping> 


(5) 在 WebRoot 目录 下 新 建 stutsjsp 页 面 , 在 页 面 中 请 求 下 reeChartAction 类 , 即 如 下 所 示 。 


<img src="jfreechart/jfreeChart.action" border="0"> 


12.6.4 运行 结果 


运行 strutsjsp 页 面 ， 出 现 如 图 12-10 所 示 的 页 面 。 


机 电 请 身 统 计 图 


12-10 ”整合 Struts 2 和 JFreeChart 生 成 统计 图 


12.6.5 ”实例 分 析 


Eee 


在 上 案例 中 ， 在 页 面 中 以 <img src="jfreechart/jfreeChart.action"” border="0"> 方 式 请 求 
JFreeChartAction 类 ，JFreeChartAction 类 继承 了 ActionSupport 类 ， 无 需 重 写 execute() 方 法 ， 当 
请 求 下 reeChartAction 类 时 ， 系 统 执 行 父 类 中 的 execute() 方 法 ， 并 返回 success 字符 串 作 为 逻辑 
视图 。 在 配置 Action 类 时 配置 了 一 个 chart 类 型 的 Result， 系 统 会 自动 加 载 JFreeChartAction 类 
中 的 chart 对 象 ， 生 成 统计 图 表 。 
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12.7 ”常见 问题 解答 


12.7.1 ” JFreeChart 中 文 乱码 问题 


[@ JFreeChart 中 文 乱 码 问题 ! 
[全 全 ”网络 课堂 : http:/Wbbs.itzcn.comythread-11013-1-1.html 
今天 我 在 做 一 个 由 JFreeChart 生成 的 柱状 图 ， 它 的 标题 是 中 文 的 ， 可 是 在 页 面 上 显示 的 都 
是 “框框 ”， 让 我 郁闷 了 半天 ， 怎 么 解决 JFreeChart 的 中 文 乱码 问题 ? 
【解决 办 法 】: 使 用 JEreeChart 生成 统计 图 ， 出 现 乱码 问题 ， 是 属性 设置 问题 ， 用 以 下 方 
式 可 以 解决 ， 请 看 下 面 的 代码 。 
chart.getLegend() .setItemFont (CHART FONT) 
chart .getTitle() .setFont (CHART FONT); 
// 获得 坐标 轴 对 象 Axis, 横 轴 对 象 : 


Axis axis=chart.getCategoryPlot() .getDomainRxis () 7 
// 纵 轴 对 象 : 

Axis axisl=chart.getCategoryP1lot () .getRangeAxis () 7 
axis.setLabelFont (CHART_FONT) ; // 坐标 轴 的 字体 ,下 同 
axis.setTickLabelFont (CHART_FONT); // 图 中 间 的 字体 ， 
axisl.setLabelFont (CHART FONT); 


不 管 是 柱状 图 、 折 线 图 还 是 饼 图 ， 这 段 代 码 都 有 效 。 
12.7.2 ”在 unix 操 作 系统 下 使 用 JFreeChart 问 题 


在 unix 操作 系统 下 使 用 JFreeChart 问题 ! 
网 络 课堂 : http://bbs.itzen.com/thread-11014-1-1.html 


我 电脑 的 操作 系统 是 unix 操作 系统 ， 使 用 JFreeChart 生成 统计 图 时 遇 到 下 面 问题 。 
Can’t connect to X11 window 


【解决 办 法 】: 遇 到 此 问题 ， 可 以 通过 在 启动 时 加 -Djava.awt.headless=true 参数 来 解决 。 


12.7.3 使 用 JFreeChart 生 成 统计 图 出 现 UnsatisfiedLinkError 错 误 


使 用 JFreeChart 生成 统计 图 出 现 UnsatisfiedLinkError 错误 ! 
网 络 课堂 : http:Wbbs.itzcn.cony/thread-11015-1-1.html 


今天 在 使 用 JFreeChart 与 Struts 2 整合 生成 统计 图 时 ， 出 现 java.lang.UnsatisfiedLinkError 
的 错误 ， 这 是 怎么 回 事 ? 我 查 了 好 多 资料 ， 没 弄 明白 。 急 ! 
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【解决 办 法 】: 遇 到 java.lang.UnsatisfiedLinkError 的 错误 很 可 能 是 JDK 安装 、 系 统 配置 
或 者 没 装 JDK 补丁 问题 。 在 HP-UX B.11.23 机 器 上 用 JDK1.4.2_08 就 出 现 了 下 面 错误 。 


java.lang.UnsatisfiedLinkError:initIDs at java.awt.Font.initIDs (Native 
Method) 


把 安装 的 JDK1.4.2_08 换 成 JDK1.4.2_02 就 可 以 了 。 
12.7.4 ”每 次 生成 JFreeChart 统 计 图 都 会 殷 出 异常 


每 次 生成 JFreeChart 统计 图 都 会 抛 出 异常 ! 
网 络 课堂 : http://bbs.itzen.com/thread-11018-1-1.html 


每 次 生成 JFreeChart 统计 图 的 时 候 ， 都 会 抛 出 异常 ， 异 常 指出 问题 出 在 ChartFactory. 
createXYLineChart(piceName,” 时 间 轴 ”,” 数 据 ”,xydataset,true,true,false) 这 行 代码 上 (或 create 其 他 
类 型 的 chart 代码 上 )。 这 是 怎么 回 事 ? 

【解决 办 法 】: 由 于 下 reeChart 用 到 的 画图 库 是 Java AWT， 所 以 需要 确保 JVM 运行 在 
headless 模式 下 ， 如 果 在 Unix 系统 中 使 用 下 reeChart， 需 要 在 Tomcat 的 bin 目录 下 catalina.sh 
文件 中 run 和 start 两 处 添加 下 面 代码 。 


java.awt.headless=true 


12.7.5 JFreeChart 生成 的 统计 图 时 间 轴 中 时 间 的 显示 格式 问题 


JFreeChart 生成 的 统计 图 时 间 轴 中 时 间 的 显示 格式 问题 ! 
网 络 课堂 : http://bbs.itzen.com/thread-11020-1-1.html 

【解决 办 法 】: 在 生成 两 组 或 者 多 组 数据 的 chart 时 ， 分 为 以 下 两 种 情况 。 

-种 是 X 轴 和 YY 轴 数 据 都 仅仅 只 是 数据 ， 则 可 以 直接 使 用 ChartFactory.createXYLine 
Chart(piceName,X 轴 数 据 ”Y 轴 数 据 ”,xydataset,true,true,false) ，xydataset 是 通过 
XYSeriesCollection 收集 XYSeries 获取 的 数据 生成 ， 代 码 如 下 。 


XYSeries[] xyseries=new XYSeries[count]; 


for(int 主 = 0 < county 1 于 fk 
xyseries[i] = new XYSeries (name [i]); 

} 

xyseries[1] .add (double arg0,double argl); 

xyseries[2] .add (double arg0,double argl); 


两 组 数据 都 必须 以 双 精 度 格式 传 入 , 在 chart 统计 图 中 的 义 轴 和 YY 轴 数 据 也 都 会 以 双 精 度 
格式 显示 。 

另 一 种 是 X 轴 数据 是 时 间 , Y 轴 数 据 为 与 这 个 时 间 对 应 的 一 个 有 一 定 精确 度 的 数据 , 这 种 
情况 就 得 使 用 ChartFactory.createTimeSeriesChart(picName,“ 时 间 轴 ”,“ 数 据 ”,xydataset,true,true, 
false)，xydataset 是 通过 TimeSeriesCollection 收集 TimeSeries 获取 的 数据 生成 ， 代 码 如 下 。 
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TimeSeries timeseries[] = new TimeSeries[count]; 
forl(int 1 = 0; 1i < counts 1 ++){ 
timeseries[i] = new TimeSeries (name[i],Minute.class); 
. 
timeseries[0] .addorUpdate (new Minute (minute,hour,date,month,year), double 
argl1) 7 
timeseries[1] .addorUpdate (new Minute (minute,hour,date,month,year), double 
argl1) 7 


@ ”这 里 使 用 addOrUpdate 而 不 使 用 add 的 原因 是 : 如 果 使 用 add 的 话 ， 传 入 一 次 数 

注意 据 ， 生 成 一 个 chart 统计 图 ， 当 下 一 次 其 他 某 个 地 方 再 调用 这 个 方法 生成 chart 统 
计 图 的 时 候 ， 就 会 报 出 数据 冲突 的 异常 信息 ， 估 计 是 上 次 传 入 的 数据 没有 清除 掉 
的 原因 ， 所 以 为 了 防止 这 种 情况 一 般 都 使 用 addOrUpdate。 


两 组 数据 是 以 (时 间 、 双 精度 数据 ) 成 对 传 入 的 ，X 轴 将 会 是 一 个 时 间 轴 ， 而 且 会 以 通用 的 
时 间 格 式 进行 显示 ， 显 示 的 时 间 格 式 可 以 在 代码 中 定制 ， 详 细 代 码 如 下 。 


DateAxis dateaxis = (DateAxis)xyplot.getDomainAxis(); 
dateaxis.setDateFormatOverride (new SimpleDateFormat ("时 间 格 式 ")); 


12.8 习 题 


一 、 填 空 题 
(1) 在 整合 Struts 2 与 下 reeChart 时 ， 需 要 配置 struts.xml 文件 ， 代 码 如 下 。 


<struts> 
<package name="jfreechart-default" extends="struts-default"> 
<result-types> 
<result-type name=" og 
class="org.apache.struts2.dispatcher.ChartResult"> 
<param name="height">150</param> 
<param name="width">200</param> 
</result-type> 
</result-types> 


</package> 
</struts> 
划 横 线 处 应 该 填 机 
(2) 柱状 图 的 DataSet 一 般 是 用 CatagoryDataset 接口 ， 具 体 实现 类 是 a 


(3) 生成 时 间 顺 序 图 需要 使 用 XYDataset 实例 作为 统计 图 的 底层 数据 ， 具 体 实现 类 是 


< 
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二 、 选 择 题 
(1) JFreeChart 开发 步骤 可 以 分 为 4 大 步 ， 顺 序 是 
a. 提供 一 个 Dateset 实例 ， 该 实例 里 包含 了 创 创 建 统 计 图 表 的 数据 。 
b. 得 到 了 JFreeChart 对 象 后 ,可 以 调用 setTitle 来 修改 统计 图 表 的 标题 ,或 者 调用 getLegend0) 
方法 来 获得 指定 索引 的 图 表 图 例 ， 取 得 图 例 对 象 后 即 可 修改 图 表 的 图 例 。 
c. 使 用 ChartFactory 的 多 个 工厂 方法 createXxxChart0 来 创建 统计 图 表 ， 统 计 图 表 就 是 一 
个 JEFreeChart 对 象 。 
d. 通过 JFreeChart 对 象 的 getPlot( 方 法 ， 即 可 获得 图 表 的 Plot 对 象 ， 该 对 象 对 应 于 统计 图 
表 的 实际 图 表 部 分 ， 可 以 调用 Plot 对象 的 方法 来 修改 图 表 中 的 各 种 显示 内 容 。 
A. a、b、c、d B. a.b.d.c 
C. a.c.b.d D. b、a、c、d 
(2) 生成 带 交互 功能 的 统计 图 需要 使 用 JFreeChart 项 目的 3 个 核心 API， 分 别 是 


A. XxxToolTipGenerator XxxURLGenerator ChartRendererInfo 
B. XxxToolTipGenerator XxxDataset ChartFactory 

C. JFreeChart XxxURLGenerator ChartRendererInfo 

D. JFreeChart XxxDataset ChartFactory 


(3) 配置 类 型 为 chart 的 Result 时 ， 可 以 指定 两 个 参数 : 和 ， 这 两 
个 参数 分 别 指定 统计 图 的 宽 和 高 。 
A. width tall B. wide tall C. width height D. wide height 
三 、 上 机 练习 


上 机 练习 : Struts 2 与 JFreeChart 整合 生成 “企业 备案 图 ” 。 
要 求 : 使 用 JfreeChart 与 Struts 2 整合 ， 在 JSP 页 面 中 生成 一 张 “企业 备案 图 ”。 这 张 “ 企 
业 备案 图 ” 横 轴 上 显示 的 是 数据 ， 纵 轴 上 显示 的 是 各 局 名 称 ， 如 图 12-11 所 示 。 


12-11 JFreeChart 与 Struts 2 整合 生成 “企业 备案 图 ” 


mt >> 
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内 容 摘要 : 


Ajax 非常 完美 地 改善 了 用 户 体验 ， 使 用 户 体验 了 一 种 连续 的 状态 ， 避 免 了 传统 的 Web 应 
旦 。Ajax 使 用 户 可 以 连续 发 送 多 次 异步 请 求 ， 不 需要 等 待 服 
务 器 响应 。 当 服务 器 的 响应 成 功 返 回 浏览 器 时 ， 浏 览 器 利用 DOM 将 服务 器 响应 数据 加 载 到 当 
前 页 面 的 相应 容器 中 。 

Struts 2 提供 了 完备 的 MVC 功能， 同时 也 提供 了 简单 易 用 的 Ajax 支持 。Struts 2 的 Ajax 
支持 需要 建立 在 DWR 和 Dojo 这 两 个 非常 成 元 的 Ajax 框架 。Struts 2 在 这 两 个 框架 的 基础 上 ， 
进行 了 进一步 的 封装 ， 从 而 简化 了 Ajax 的 开发 。 

本 章 主 要 讲解 Struts 2 的 Ajax 支持 。 采 用 Ajax 方式 输入 校 验 ， 如 果 输 入 不 合法 的 数据 ， 
系统 自动 显示 校 验 提示 。 还 允许 使 用 Dojo 异步 获取 数据 请 求 ， 并 提供 了 一 系列 的 Ajax 标签 来 
简化 Ajax 开发 。 

学 习 目标 : 

@ 掌握 Ajax 的 输入 校 验 。 

了 解 DWR 框架 的 使 用 。 

掌握 JSON 串 作 为 数据 的 载体 。 
熟悉 Dojo 框架 的 使 用 。 

掌握 Struts 2 的 Ajax 标签 。 
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13.1 用 户 注 册 校 验 


Ajax 的 输入 校 验 是 服务 器 端 校 验 , 不 是 客户 端 校 验 , 这 种 服务 器 端 校 验 是 以 异步 方式 进行 
的 ， 不 需要 浏览 者 显示 提交 校 验 请 求 ， 当 浏览 者 输入 完成 后 ， 系 统 自动 完成 校 验 。 


9 
加 ,视频 教学 : 光盘 /videos/13/InputAjax.avi 图 长 度 : 7 分 钟 


13.1.1 基础 知识 基于 Ajax 的 输入 校 验 


Stmuts 2 的 Ajax 校 验 建立 在 DWR 和 Dojo 两 个 框架 之 上 , 其 中 DWR 负责 实现 在 JavaScript 
中 调用 远程 Java 方法 ，Dojo 则 负责 实现 页 面 上 的 效果 。 本 节 先 让 读者 了 解 一 下 Ajax 和 DWR 
的 相关 简介 ， 然 后 学 习 DWR 的 下 载 与 配置 应 用 ， 最 后 结合 实例 深入 学 习 Ajax 的 输入 校 验 。 

1. Ajax 简介 

Ajax 不 是 一 种 新 的 编程 语言 ， 而 是 一 种 用 于 创建 更 好 更 快 以 及 交互 性 更 强 的 Web 应 用 程 
序 的 技术 。 

通过 Ajax， 可 以 使 用 JavaScript 的 XMLHttpRequest 对 象 来 直接 与 服务 器 进行 通信 。 通 过 
这 个 对 象 ， 编 写 的 JavaScript 可 以 在 不 重 载 页 面 的 情况 与 Web 服务 器 交换 数据 。 

1) Ajax 的 优点 

首先 介绍 Ajax 的 主要 优点 。 

(1) 有 针对 性 的 数据 传输 。 

Ajax 的 原则 是 “ 按 需 取 数 据 ”， 可 以 最 大 限度 的 减少 元 余 请 求 ， 和 响应 对 服务 器 造成 的 负 
担 。 例 如 ， 新 用 户 名 的 检测 ， 如 果 使 用 Ajax 技术 进行 检测 ， 它 可 以 只 将 用 户 名 信息 传送 到 服 
务 器 ， 而 不 需要 传送 整个 表单 数据 。 从 服务 器 端 获取 相关 返回 数据 后 ， 它 又 可 以 只 向 客户 端 传 
输 这 些 反馈 数据 ， 而 不 需要 刷新 整个 页 面 而 导致 页 面 中 其 他 代码 内 容 被 重新 传输 。 

(2) 无 刷新 更 新 页 面 。 

减少 用 户 心理 和 实际 的 等 待 时 间 。 当 要 读 取 大 量 的 数据 的 时 候 ， 不 用 像 Reload 那样 出 现 
白 屏 的 情况 ，Ajax 使 用 XMLHTTP 对 象 发 送 请 求 并 得 到 服务 器 响应 ， 在 不 重新 载 入 整个 页 面 
的 情况 下 用 JavaScript 操作 DOM 最 终 更 新 页 面 。 所 以 在 读 取 数 据 的 过 程 中 ， 用 户 所 面 对 的 不 
是 白 屏 ， 是 原来 的 页 面 内 容 (也 可 以 一 个 Loading 的 提示 框 让 用 户 知道 处 于 读 取 数 据 过 程 )， 只 
有 当 数 据 接收 完毕 之 后 才 更 新 相应 部 分 的 内 容 。 这 种 更 新 是 瞬间 的 ， 用 户 几 乎 感觉 不 到 。 

(3) 基于 公开 的 标准 。 

Ajax 技术 是 基于 已 经 被 各 大 浏览 器 和 平台 都 支持 的 公开 标准 的 技术 。 组 成 Ajax 技术 的 大 
多 数 技术 都 经 过 很 多 年 的 实践 考验 。 


>>> 
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(4) 跨 平台 跨 浏览 器 的 兼容 性 。 

占据 市 场 份额 最 大 的 两 个 浏览 器 是 正 和 基于 Mozilla 的 FireFox， 而 它们 都 支持 在 浏览 器 
上 轻松 创建 基于 Ajax 的 Web 应 用 。 这 也 是 Ajax 应 用 变 得 如 此 流行 的 一 个 最 重要 的 原因 。 

(5) 技术 独立 性 。 

和 Ajax 技术 浏览 器 的 独立 性 相同 ， 该 技术 也 兼容 所 有 标准 型 的 服务 器 和 服务 端 语言 ， 如 
PHP、ASP、ASP.Net、Perl、JSP 和 Cold Fusion 等 。 这 使 得 Ajax 开发 具有 独立 性 ， 所 有 的 开 
发 人 员 都 能 使 用 并 且 一 起 讨论 相同 的 表现 层 。 

2) Ajax 的 缺点 

没有 绝对 完美 的 事物 ，Ajax 也 有 它 的 一 些 缺 点 。 

(1) 浏览 器 的 通用 性 ， 每 个 客户 的 浏览 器 不 尽 相 同 、 版 本 也 不 一 致 ， 有 可 能 会 造成 一 些 操 
作 无 法 进行 。 

(2) 客户 端 会 过 肥 ， 太 多 程序 代码 在 客户 端 也 会 造成 开发 上 的 成 本 。 

(3) 可 能 会 暴露 服务 端 ， 有 可 能 被 恶意 攻击 、 窜 改 ， 而 造成 安全 上 的 漏洞 。 

3) Ajax 的 工作 原理 

Ajax 通过 Ajax 引擎 (其 核心 是 XMLHttpRequest 对 象 ) 与 服务 器 进行 交互 。Ajax 引擎 向 服务 
器 发 送 请 求 后 ，Ajax 在 服务 器 状态 发 生变 化 时 通知 JavaScript 脚本 程序 来 处 理 相应 的 件 。Ajax 
的 工作 原理 如 图 13-1 所 示 。 


13-1 Ajax 的 工作 原理 


2. DWR 的 简介 


DWR(Direct Web Remoting) 是 一 个 用 于 改善 Web 页 面 与 Java 类 交互 的 远程 服务 器 端 Ajax 
开源 框架 ， 可 以 帮助 开发 人 员 开 发 包含 Ajax 技术 的 网 站 。 它 可 以 允许 在 浏览 器 里 的 代码 使 用 
运行 在 Web 服务 器 上 的 Java 函数 ， 好 像 它 就 在 浏览 器 里 一 样 。 

利用 一 个 Ajax 框架 ( 指 DWR) 构 造 一 个 应 用 程序 ， 它 直接 从 浏览 器 与 后 端 服务 进行 通信 。 
如 果 使 用 得 当 ， 这 种 强大 的 力量 可 以 使 应 用 程序 更 加 自然 和 响应 灵敏 ， 从 而 提升 用 户 的 浏览 
体验 。 

Struts 2 中 的 ajax 主题 是 在 XHTML 主题 基础 上 的 扩展 ， 增 加 了 Ajax 数据 校 验 功能 。Ajax 
输入 校 验 不 是 基于 客户 端 ， 而 是 基于 服务 器 端 ， 是 以 异步 方式 实现 的 校 验方 式 。 


\ 
0 | 日前 ，Struts 2 中 的 Ajax 输入 验证 使 用 的 是 DWR 框架 . 


< 


[~ WW 2 sax 


3. 下 载 与 配置 DWR 


使 用 DWR 框架 需要 在 Web 应 用 中 加 载 DWR 的 JAR 文件 dwrjar， 可 以 进入 到 DWR 的 
官方 网 站 “http://directwebremoting.org/dwr/downloads/index.html ”进行 下 载 ， 下 载 完 成 后 ， 将 
dwrjar 复制 粘贴 到 Web 应 用 程序 的 WEB-INF/lib 目录 下 。 


目前 DWR 的 最 新 版 本 是 3.0, 但 是 Struts 2 的 2.1.8 版 本 不 支持 最 新 版 本 ， 因 此 只 
注意 能 使 用 DWR 的 2.0 或 以 下 版 本 ,本 书 中 使 用 的 是 DWR 1.1.3 版 本 ,相对 比较 稳定 。 


仅 下 载 DWR 的 Jar 包 是 不 能 在 项 目 中 使 用 DWR 框架 的 ， 还 需要 在 项 目的 web.xml 文件 
中 配置 DWR 的 核心 Servlet， 详 细 配 置 如 下 所 示 。 


<servlet> 
<servlet-name>dwr</servlet-name> 
<servlet-class>uk.1ltd.getahead.dwr.DWRServlet</servlet-class> 
<init-param> 
<param-name>debug</param-name> 
<param-value>true</param-value> 
</init-param> 
</servlet> 
<servlet-mapping> 
<servlet-name>dwr</servlet-name> 


<url-pattern>/dwr/*</url-pattern> 
</servlet-mapping> 


增加 了 DWR 的 核心 Servlet 后 ， 该 Servlet 负责 将 服务 器 端的 Java 方法 暴露 出 来 。 具 体 被 
暴露 的 Java 方法 ， 在 dwrxml 配置 文件 中 指定 。dwr.xml 文件 需要 放 到 WEB-INF/lib 目录 下 ， 
配置 信息 如 下 所 示 。 

<?xml] Version="1.0"” encoding="UTF-8"?> 

<!-- START SNIPPET: dwr --> 
<!DOCTYPE dwr PUBLIC 


"-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN" 
"http://www.getahead.ltd.uk/dwr/dwr10.dtd"> 


<dwr> 
<!-- 定义 所 有 需要 被 暴露 的 Java 方法 --> 
<allow> 


<create creator="new" javascript="validator"> 
<param name="class" 
value="org.apache.struts2.validators.DWRValidator" /> 
</create> 
<convert converter="bean" 
match="com.opensymphony .xwork2.ValidationAwaresupport" /><!-- 定 
义 一 个 转换 器 --> 
</allow> 
<signatures> 
<! [CDATAI[ 
import java.util.Map; 


import org.apache.struts2.validators.DWRValidator; 
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DWRValidator.doPost (string, String, Map<string, String>); 
J 


</signatures> 
</dwr> 
<!-— END SNIPPET: dwr --> 


在 dwr.xml 配置 文件 中 ， 将 org.apache.struts2.validators.DWRValidator 类 创建 成 一 个 Java 
Script 对 象 ， 名 为 validator。DWR 框架 提供 一 种 方式 ， 允 许 在 客户 端 调用 validator 的 方法 时 ， 
转换 成 调用 DWRValidator 实例 的 方法 。 


在 具体 的 项 目 应 用 中 ,开发 者 只 需 利用 Struts 2 对 DWR 的 封装 即 可 . 在 WEB-INF 
提示 | 。 路 径 下 添加 dwrxml 文件 ， 而 且 dwrxml 文件 的 代码 也 是 固定 不 变 的 。 


13.1.2 ”实例 描述 


前 几 天 在 网 上 看 到 一 件 衣服 很 漂亮 ， 我 很 喜欢 于 是 就 想 买 下 来 。 首 先 注册 一 个 账号 ， 输 入 
注册 用 户 信息 ， 当 输入 密码 时 ， 在 输入 框 后 面 ， 显 示 了 输入 错误 提示 “用 户 密码 必须 为 6-20 
位 ”， 没 办 法 只 好 换个 符合 要 求 的 密码 。 这 种 情况 估计 经 常 上 网 的 朋友 都 遇 到 过 ， 其 实 这 就 是 
本 节 实 例 要 实现 的 用 户 注册 校 验 ， 检 查 用 户 输入 信息 是 否 合法 ， 不 合法 给 出 相应 提示 信息 。 


13.1.3 ”实例 应 用 


【 例 13-1】 用 户 注册 校 验 。 
(1) 新 建 一 个 Struts2_13 项 目 , 为 了 让 DWR 的 核心 Servlet 起 作用 ， 必 须 在 web.xml 文件 
中 配置 该 核心 Servlet。 配 置 DWR 的 核心 Servlet 的 代码 如 下 所 示 。 


<?xml Version="1.0"” encoding="UTF-8"?> 
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.0rg/2001/xMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app 2 5.xsd"> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
<!-- Struts 2 核心 控制 器 配置 --> 
<filter> 
<filter-name>struts</filter-name> 


<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter- 
class> 
<init-param> 
<param-name>actionPackages</param-name> 
<param-value>org.apache.struts2.showcase.person</param-value> 
</init-param> 
</filter> 
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<filter-mapping> 
<filter-name>struts</filter-name> 
<url-pattern>/*</url-pattern> 

</filter-mapping> 

<!-- 配置 DWR 的 核心 Servlet --> 

<servlet> 


<servlet-name>dwr</servlet-name> 


<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class> 


<init-param> 
<param-name>debug</param-name> 
<param-value>true</param-value> 
</init-param> 
</servlet> 
<servlet-mapping> 
<servlet-name>dwr</servlet-name> 
<url-pattern>/dwr/*</url-pattern> 
</servlet-mapping> 
</web-app> 


(2) 在 上 面 web.xml 文件 中 添加 了 DWR 的 核心 Servlet 后 ， 该 Servlet 将 负责 暴露 服务 器 
端的 Java 方法 , 通过 dwrxml 配置 文件 制定 需 暴 露 的 Java 方法 , 在 项 目 WEB-INF 目录 下 新 建 


-个 dwrxml 文件 ， 在 该 文件 中 添加 如 下 配置 代码 。 


<?xml version="1.0" encoding="UTF-8"?> 
<!-- START SNIPPET: dwr --> 
<!DOCTYPE dwr PUBLIC 
"-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN" 
"http://www.getahead.ltd.uk/dwr/dwr1l0.dtd"> 
<dwr> 
<allow> 
<create creator="new" javascript="validator"> 
<param name="class" 
value="org.apache.struts2.validators.DWRValidator" /> 
</create> 
<convert converter="bean" 
match="com.opensymphony .xwork2.ValidationAwareSupport" 
</allow> 
<signatures> 
<! [CDRATRA[ 
import java.util.Map; 
import org.apache.struts2.validators.DWRValidator; 
DWRValidator.doPost (String, String, Map<Sstring, String>); 
]]> 


</signatures> 
</dwr> 
<!-- END SNIPPET: dwr 一 -> 


> 


(3) 在 项 目 src 目录 下 新 建 一 个 com.gdupt.action 包 ， 在 该 包 下 再 新 建 一 个 RegisterAction 
类 ， 用 于 处 理 用 户 注册 请 求 ， 代 码 如 下 所 示 。 
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package com.gdupt.action; 
import com.opensymphony .xwork2.Actionsupport; 
public class RegisterAction extends Actionsupport { 


private String username; // 用 户 名 
private String password; // 密 码 
private int age; // 年 龄 


// 下 面 是 username、password 和 age 属性 的 get 和 set 方法 ， 在 此 省 略 了 。 
// 


public String execute(){ 
return SUCCESS; 


(4) 在 项 目 src 目录 下 新 建 一 个 struts.xml 文件 ， 在 该 文件 中 添加 RegisterAction 的 配置 ， 
代码 如 下 所 示 。 


<?xml Version="1.0"” encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 


"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 


<package name="default" extends="struts-default"> 
<action name="userregister" class="com.gdupt.action.RegisterAction"> 
<result name="input">/index.jsp</result> 
<result name="success">/success.jsp</result> 
</action> 
</package> 
</struts> 


(5) 在 RegisterAction 所 在 目录 下 , 新 建 一 个 RegisterAction-validation.xml 文件 , 在 该 文件 
中 设置 校 验 规则 ， 来 完成 输入 校 验 ， 本 输入 校 验 文件 使 用 字段 校 验 器 风格 来 配置 校 验 规则 。 配 
置 代码 如 下 所 示 。 


<!DOCTYPE validators PUBLIC 
"”-//openSymphony Group//XWork Validator 1.0.2//EN" 


"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> 
<validators> 


<field name="username"> 
<field-validator type="requiredstring"> 
<message> 用 户 名 是 必 填 内 容 </message> 
</field-validator> 
</field> 
<field name="password"> 
<field-validator type="requiredstring"> 


<message> 密 码 是 必 填 的 内 容 !</message> 
</field-validator> 
</field><field name="age"> 
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<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">130</param> 
<message> 年 龄 必须 在 1 到 130 之 间 </message> 
</field-validator> 
</field> 
</validators> 


(6) 新 建 一 个 register.jsp 页 面 ， 为 了 实现 Ajax 校 验 ， 需 要 将 表单 设置 成 Ajax 主题 ， 并 且 
设置 validate=“true”。 当 某 个 输入 组 件 失去 焦点 时 ， 系 统 会 负责 将 输入 内 容 发 送 到 服务 器 端 
进行 校 验 。 该 页 面 实现 代码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@taglib uri="/struts-tags" prefix="s"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<s:head theme="ajax"/> 
</head> 
<body> 
<s:form method="post" action="userregister" validate="true" 
theme="ajax"> 
<s:textfield label=" 用 户 名 " name="username" /> 
<s:password label=" 密 码 " name="password"></s:password> 
<s:textfield label=" 年 龄 " name="age"></s:textfield> 
<s:submit value=" 注 册 " /> 
</s:form> 
</body> 
</html> 


(7) 新 建 一 个 success.jsp 页 面 , 当 用 户 注册 成 功 后 跳 转 到 success.jsp 页 面 , 代码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 注 册 成 功 </title> 
</head> 
<body> 
恭喜 您 ， 注 册 成 功 ! <br> 
</body> 
</html> 


13.1.4 运行 结果 
打开 正 浏 览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_13/register.jsp”， 进 入 注册 


页 面 ， 如 果 在 用 户 输入 信息 表单 中 输入 不 合法 的 信息 或 不 输入 任何 信息 ， 单 击 “ 注 册 ” 按 钮 提 
交 表 单 ， 经 过 验证 之 后 会 在 输入 框 上 方 给 出 相应 的 提示 信息 ， 执 行 效果 如 图 13-2 所 示 。 


st >> 
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图 13-2 用 户 注册 


13.1.5 “实例 分 析 


ri : 

本 实例 实现 Struts 2 支持 的 Ajax 校 验 ,首先 需要 在 web.xml 文 件 中 添加 DWR 的 核心 Servlet 
配置 和 在 项 目 WEB-INF 目录 下 添加 dwr.xml 文件。 

然后 新 建 一 个 RegisterAction 类 ， 在 该 Action 中 声明 用 户 注 册 信息 属性 ， 如 : username、 
Password、age。 接 下 来 在 RegisterAction 类 所 在 目录 下 ,创建 一 个 RegisterAction-validation.xml 
在 该 文件 中 设置 校 验 规 则 ， 来 完成 输入 校 验 。 

最 后 创建 一 个 用 户 注册 页 面 register.jsp， 当 用 户 输入 不 合法 注册 信息 时 ， 系 统 将 自动 提交 
校 验 ， 并 给 出 提示 信息 。 


13.2 ”JSON 串 传递 顾客 信息 数据 


XML 的 作用 就 是 利用 规范 的 文档 来 格式 化 数据 内 容 , 所 以 在 使 用 XML 时 ， 需 要 编写 很 多 
格式 内 容 。 从 数据 传输 量 上 来 看 JSON 显然 要 优 于 XML，JSON 更 轻 量 级 一 些 ， 它 没有 像 XML 
那样 多 的 Open 和 Closing 标记 。 同 时 在 对 数据 的 解析 速度 上 ，JSON 也 要 优 于 XML。 因 此 使 
用 JSON 传递 数据 相对 比较 方便 。 


A9 
时? 视频 教学 : 光盘 /videos/13/json.avi 个 长 度 : 8 分 钟 
光盘 /videos/13/jsonl.avi 人 @@ 长 度 : 5 分钟 
光盘 /videos/13/json2.avi @@ 长 度 :14 分钟 


13.2.1 基础 知识 一 一 使 用 JSON 串 作为 数据 的 载体 


JSON 插件 是 Struts 2 的 Ajax 插件 ， 使 用 JSON 插件 ， 可 以 使 开发 者 非常 灵活 的 开发 Ajax 
应 用 ， 而 且 整 个 开发 过 程 非 常 简单 。 本 节 将 学 习 如 何在 Struts 2 中 使 用 JSON 传递 数据 信息 。 


“ws 


< 
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1. JSON 概 述 

JSON(JavaScript Object Notation) 是 一 种 轻 量 级 的 数据 交换 格式 。 易 于 人 阅读 和 编写 ， 同 时 
也 易于 机 器 解析 和 生成 。 它 基于 JavaScript(Standard ECMA-262 3rd Edition - December 1999) 的 

-个 子 集 。JSON 采用 完全 独立 于 语言 的 文本 格式 , 但 是 也 使 用 了 类 似 于 C 语言 家 族 的 习惯 ( 包 
括 C、C++、C#、Java、JavaScript、Perl、Python 等 )。 这 些 特性 使 JSON 成 为 理想 的 数据 交换 
语言 。 

2. JSON 构 建 结构 

JSON 有 两 种 构建 结构 。 

(1) “名 称 / 值 ” 对 的 集合 (A collection of name/value pairs) 

不 同 的 语言 中 ， 它 被 理解 为 对 象 (object)， 记 录 (record)， 结 构 (struct)， 字 上 典 (dictionary)， 哈 
希 表 (hash table)， 有 键 列表 (keyed list)， 或 者 关联 数组 (associative array)。 

(2) 值 的 有 序列 表 (An ordered list of values) 

在 大 部 分 语言 中 ， 它 被 理解 为 数组 (Array)。 这 些 都 是 常见 的 数据 结构 。 事 实 上 大 部 分 现代 
计算 机 语言 都 以 某 种 形式 支持 它们 。 这 使 得 一 种 数据 格式 在 同样 基于 这 些 结构 的 编程 语言 之 间 
交换 成 为 可 能 。 

3. JSON 的 数据 格式 

JSON 具有 如 下 这 些 数据 格式 。 

1)” ”对象 (Object) 

对 象 (Objecb 是 一 个 无 序 的 ““ 名 称 / 值 ”对 ”集合 。 一 个 对 象 以 “{” 开 始 ， 以 “} ”结束 。 
每 个 “名 称 ” 后 跟 一 个 “:”，“ “名 称 / 值 ”对 ”之 间 使 用 “,” 分 隔 。 如 图 13-3 所 示 。 


re 本 本 RE 
@ = 和 = Q) 
(2 


13-3 ”对 象 数 据 格式 图 
在 JavaScript 中 使 用 JSON 对 象 语法 创建 对 象 ， 代 码 如 下 所 示 。 


<script type="text/javascript"> 
var book = {"bookname":"Struts 2 与 Ajax 碰面 ", "price":52}; 
alert (" 书 名 : "+book .bookname+", 单 价 : "+book.price); 
</script> 
2) 数组 
数组 是 值 的 有 序 集合 。 一 个 数组 以 “[” 开始, “]” 结 束 。 值 之 间 使 用 “,” 分 隔 。 如 图 13-4 


所 示 。 
EEC 和 | 下 和 
(2 


13-4 ”数组 数据 格式 


第 13 章 当 Struts 2 碰见 Ajax 


在 JavaScript 中 使 用 JSON 数组 语法 创建 数组 ， 代 码 如 下 所 示 。 


<script type="text/javascript"> 
Var string array = [" 你 好 ", "Hello", "nihao"]; 
for (var i=0;i<string array.length;i++){ 


alert (String array[il]); 


} 
</script> 
3) 值 


值 可 以 是 双 引 号 括 起 来 的 字符 串 、 数 值 、true、false、null、 对 象 或 者 数组 。 这 些 结构 可 以 
嵌 套 。 如 图 13-5 所 示 。 


value 


图 13-5 值 的 数据 格式 图 
在 数组 中 婴 套 数值 ， 代 码 如 下 所 示 。 
<script type="text/javascript"> 
var num =[10,11,12,13]; 
</script> 
4) 字符 串 
字符 串 是 由 双 引 号 包围 的 任意 数量 Unicode 字符 的 集合 ， 使 用 反 和 斜体 转 义 。 一 个 字符 即 一 
个 单独 的 字符 串 。 如 图 13-6 所 示 。 


图 13-6 字符 串 的 数据 格式 图 
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例如 如 下 所 示 。 


<script type="text/javascript"> 
var str = {"welcome":" 欢 迎 "}; 
alert (str.welcome); 


</script> 

5) 数值 

数值 也 与 C 或 者 Java 中 的 数值 非常 相似 ， 但 不 
和 十 六 进 制 格式 。 如 图 13-7 所 示 。 


number 


区 分 整 型 值 和 浮 点 型 值 ， 也 不 支持 八 进 


制 


图 13-7 数值 的 数据 格式 图 
学 习 了 JSON 的 数据 格式 ， 下 面 我 们 就 趁 热 打 铁 ， 来 看 一 个 使 用 JSON 来 标记 地 址 薄 的 数 


据 ( 包 含 全 称 、 起 始 地 址 、email 地 址 、 电 话 、 家 庭 住 址 ， 


1 
"fullname": "Sean Kelly"， // 全 称 
"org": "SK Consulting"，// 起 始 地 址 


等 等 )。 代 码 如 下 所 示 。 


"emailaddrs": [ //email 地 址 
{"type": "work", "value": "kelly@seankelly.biz"}, 
{type": "home”r “pref™”: 1 “value": "kellylaseankelly-tv"} 
]， 
"telephones": [ // 电 话 
tyDe ss “Work yy "Prerw Lr “vaLue™ 24 555 L212 
te "Eazy "VALue®s +124 555 12L3"Ys 
{type™: "mobilers “Value “+1 214 555,1214"} 
]， 
"addresses": [ // 家 庭 住址 
Ftvie sl "Wr VEOrmAat®s Mus 
"value": "1234 Main stnspringfield, TX 78080-1216"}, 
{"type": "home", "format™": "us", 
"value": "5678 Main Stnspringfield, TX 78080-1316"} 
Is 
"urlsms //url 网 络 连接 地 址 
{f"type": "work"， "value": "http://seankelly.biz/"}, 
{"type": "home", "value": "http://seankelly.tv/"} 
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4. 下 载 使 用 JSON 

如 果 要 将 Java 对 象 和 数组 与 JSON 的 数据 结构 进行 交互 转换 操作 ， 就 需要 引入 JSON 的 
Java 实现 Jar 包 ， 本 书 使 用 的 是 在 JSON 的 官方 网 站 “http://www.json.org/java/index.html” 上 下 
载 json.zip 包 ， 解 压 该 文件 ， 可 以 看 到 Java 源 文件 ， 将 这 些 源 文件 导入 到 项 目 src 目录 下 即 可 


使 用 。 


在 JavaScript 中 也 可 以 直接 使 用 JSON， 因 为 它 是 JavaScript 对 象 字面 量 语法 的 子 集 ， 所 以 


只 需 下 载 


-个 JavaScript 脚本 文件 ， 登 录 JSON 的 官方 网 站 “https:Wgithub.comy 


douglascrockford/JSON-js” 即 可 json2.js 脚本 文件 , 使 用 方式 和 普通 的 JavaScript 脚本 文件 一 样 。 
$ json2jsp 文件 定义 了 三 个 方法 , 主要 用 于 将 一 个 JavaScript 对 象 转换 成 JSON 字符 


提示 | 


串 ， 或 者 将 JSON 字符 串 解 析 为 JavaScript 对 象 。 


结合 客户 端的 JSON JavaScript 脚本 和 服务 器 端的 JSON Java 实现 , 可 以 将 客户 端 JavaScript 
对 象 转换 成 JSON 串 发 送 到 服务 器 端 , 在 服务 器 端 再 将 Java 对 象 转 换 成 JSON 串 发 送 给 客户 端 ， 
这 样 就 简化 数据 的 解析 工作 。 


13.2.2 ”实例 描述 


前 几 天 同事 问 我 在 Struts 2 中 可 以 使 用 JSON 传递 数据 吗 ， 我 说 当然 可 以 了 ， 他 说 他 试 了 
但 总 是 接受 不 到 数据 ， 是 空 的 。 对 此 我 专门 抽 时 间 深 入 研究 了 一 下 JSON， 并 给 他 写 了 一 个 使 
用 JSON 串 传递 顾客 信息 数据 的 小 例子 ， 下 面 拿 出 来 与 读者 分 享 学 习 。 


13.2.3 ”实例 应 用 


【 例 13-2】 JSON 串 传 递 顾 客 信息 数据 。 
(1) 在 项 目 sre/com/struts2/action 目录 下 ， 新 建 一 个 Action 类 CustomAction， 在 该 类 中 声 
明 customName( 顾 客 姓 名 )、email( 电 子 邮 件 )、address( 地 址 ) 等 属性 ， 并 重 写 。 


package com.struts2.action; 


import 
import 
import 
import 
import 
import 
import 
public 


java.text.SimpleDateFormat; 

java.util.Date; 

java.util.HashMap; 

java.util.Map; 
com.googlecode.jsonplugin.annotations .JSON7 
com.opensymphony .xwork2.ActionSsupport; 
net.sf.json.JSONArray; 

class CustomAction extends ActionSupport{ 


private String email; 


private String address; 
private int[] ints = { 10, 20 }; 
private Map map = new HashMap (); 


private String customName = "custom"; 
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// 下 面 是 属性 email、 address、ints、 map 的 get 和 set 方法 ， 在 此 省 略 了 。 
WA 


@JSON (name="newName") 
public String getCustomName() { 
return customName; 


public void setCustomName (String customName) { 
this.customName = customName; 


public String execute(){ 
map.put ("email", "godenvoy@126.com"); 
// 格 式 化 时 间 
SimpleDateFormat format = new SimpleDateFormat ("yyyy-MM-dd HH:mm: ss"); 
// 设 置 javabean 值 
CustomAction test = new CustomAction () 7 
test .setCustomName ("admin") 7 
test.setEmail ("good@gmail.com"); 
test.setAddress (format .format (new Date())); 
test.setMap (map); 
// 格 式 化 javabean 里 的 值 
JSONArray array = JSONArray.fromObject (test) 7 
return SUCCESS; 


/*// 测 试 json 数据 格式 输出 

public static void main(String[] args) { 
// 格 式 化 时 间 
SimpleDateFormat format = new SimpleDateFormat ("yyyy-MM-dd HH:mm: ss"); 
// 设 置 javabean 值 


CustomAction test = new CustomAction () 7 
test .setCcustomName ("admin") 7 
test.setEmail ("good@gmail .com"); 
test.setAddress (format .format (new Date())); 
// 格 式 化 javabean 里 的 值 
JSONArray array = JSONArray.fromObject (test) 7 
System-out .println(array-toString())7 

有 


(2) 打开 项 目 src 目录 下 的 strutsxml 文件 ， 在 该 文件 中 添加 CustomAction 配置 信息 ， 代 
码 如 下 所 示 。 


<package name="json" extends="json-default"> 
<action name="example" class="com.struts2.action.CustomAction"> 


<result type="json"/> 


mt >> 
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</action> 


</package> 


(3) 新 建 一 个 JSP 页 面 jsonjsp， 在 该 页 面 中 创建 一 个 顾客 信息 表单 ， 当 用 户 单 击 “ 提 交 ” 
按钮 提交 表单 时 ， 将 触发 执行 gotClick0 函 数 。 

gotClickO 函 数 把 用 户 输入 的 customName( 顾 客 姓 名 )、email( 电 子 邮件 ) 和 address( 家 庭 住 
址 )， 作 为 参数 传递 给 custom.action， 并 指定 回调 函数 onComplete:processResponse， 该 回调 函 
数 再 将 Action 处 理 后 ， 返 回 的 JSON 格式 的 顾客 信息 数据 ， 显 示 在 弹出 的 对 话 框 中 。 代 码 如 下 
所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>struts2 json 插件 </title> 
<script src="prototype.js" type="text/javascript"></script> 
<script type="text/javascript"> 
function gotCclick(){ 
Var customName = $ ("customName") .value; 
Var email = $ ("email") .value; 
Var address = $("address") .value; 
// 请 求 的 地 址 
Var url = "custom.action'7 
Var req = { 
"customName":customName, 


本 


"email":email, 
"address":address 
}; 
//var params = Form.serialize('forml'); 
// 创 建 Ajax.Request 对 象 ， 对 应 于 发 送 请 求 
Var myAjax = new RAjax.Redquest( 
BEL 
{ 
// 请 求 方式 : PosT 
method: 'post', 
// 请 求 参数 
//parameters:params, 
parameters:req, 
// 指 定 回调 函数 
onComplete: processResponse, 
// 是 否 异 步 发 送 请 求 
asynchronous:true 
Ds; 
} 
function processResponse (request){ 
alert (equest .responseText); 
var result = eval("("+request.responseText+")"); 
alert(result+t™ "+result intst, "+result.email)s 
$ ("show") .innerHTML = request.responseText; 
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</script> 
</head> 
<body> 
<form id="forml" name="forml" method="post"> 
顾客 姓名 : <INPUT TYPE="text" name="customName" id="customName" 


/><br/> 
电子 邮件 : <INPUT TYPE="text" name="email" id="email" /><br/> 
家 庭 住址 : <INPUT TYPE="text" name="address" id="address" /><br/> 
<INPUT TYPE="button" value=" 提 交 " onclick="gotelicer (se /> 
</form> 
<div id="show"></div> 
</body> 
</html> 


13.2.4 运行 结果 


打开 正 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_13/json.jsp”， 输 入 顾客 信 
息 ， 如 : 顾客 姓名 、 电 子 邮 件 和 家 庭 住址 。 单 击 “ 提 交 ” 按 钮 ， 将 会 在 弹出 对 话 框 中 ， 看 到 用 
户 输入 的 顾客 信息 以 JSON 格式 显示 出 来 ， 如 图 13-8 所 示 。 


bo |S bss) 


13-8 JSON 格 式 传递 顾客 信息 


13.2.5 “实例 分 析 


Ce 


上 述 实 例 中 ， 首 先 创建 了 一 个 Action 类 CustomAction， 包 含 customName( 顾 客 姓名 )、 
email( 电 子 邮 件 ) 和 address( 家 庭 住址 ) 等 属性 ， 重 写 了 execute0) 方 法 ， 在 该 方法 中 使 用 
JSONArray.fromObject() 方 法 ， 把 CustomAction 的 实例 对 象 格 式 化 成 JSON 格式 ， 该 Action 以 
JSON 格式 返回 顾客 信息 数据 成 功 后 , 跳 转 到 json.jsp 页 面 , 在 该 页 面 中 弹出 一 个 对 话 框 来 显示 
JSON 格式 的 顾客 信息 数据 。 


mt >> 
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13.3 ”Dojo 异 步 获取 用 户 信 息 


Dojo 是 一 个 开源 的 JavaScript 工具 包 ， 本 身 由 许多 模块 组 合 而 成 ， 可 以 实现 完整 的 轻 量 
级 窗口 组 件 及 很 多 功能 。Dojo 的 包 加 载 机 制 (Package System) 可 以 实现 动态 加 载 所 需 模块 ， 而 
且 用 户 可 以 编写 自己 的 Dojo 扩展 模块 ， 有 很 大 的 灵活 性 。 


. 
?视频 教学 ， 光盘 /videos/13/dojo.avi @ 长 度 : 8 分 钟 


13.3.1 基础 知识 一 一 结合 Dojo 简 化 Ajax 应 用 的 开发 


通过 前 面 的 学 习 ， 读 者 对 Struts 2 提供 的 Ajax 支持 应 该 有 了 一 定 的 了 解 ， 本 节 将 介绍 一 个 
新 的 Ajax 框架 一 一 Dojo，Struts 2 对 它 进 行 了 完美 的 封装 ， 使 用 起 来 更 加 简单 方便 。 

1. Dojo 介 绍 

目前 浏览 器 的 种 类 有 很 多 ， 例 如 三 、FireFox、Opera 和 Safari 等 。 实 现 某 个 功能 ， 如 果 只 
针对 一 个 浏览 器 ， 代 码 的 编写 就 比较 简单 ， 而 如 果 针 对 不 同 的 浏览 器 ， 就 需要 写 不 同 的 代码 。 
使 用 Ajax 技术 时 就 需要 考虑 这 样 的 问题 ， 需 要 将 不 同 的 浏览 器 都 考虑 进去 ， 这 样 就 给 代码 的 
编写 带 来 麻烦 。 

而 Dojo 框架 能 够 解决 这 个 问题 。Dojo 不 仅 存 在 于 抽象 层 ， 而 且 是 独立 存在 的 。 它 不 只 是 
提供 一 些 库 、 方 法 和 功能 ， 而 且 能 保证 代码 只 包含 所 需要 的 部 分 ， 让 代码 更 简洁 ， 更 有 效率 ， 
并 且 可 以 更 好 的 重复 使 用 。 

@ $ Dojo 框架 是 一 个 基于 客户 端的 框架 ， 利 用 Dojo， 可 以 很 容易 为 网 页 或 其 他 任何 支 
提示 持 JavaScript 的 环境 增加 动态 能 


2. Dojo 的 特征 


Dojo 大 体 上 有 5 个 特征 ， 具 体 如 下 所 示 。 

@ ”利用 Dojo 提供 的 组 件 , 可 以 提升 Web 应 用 程序 可 用 性 、 交互 能 力 以 及 功能 上 的 提高 。 

@ ”可 以 更 容易 地 建立 互动 的 用 户 界面 。 同 时 Dojo 也 提供 小 巧 的 动态 处 理工 具 。 

@ ”利用 Dojo 的 低级 API 和 可 兼容 的 代码 , 能 够 写 出 轻便 的 、 单 一 风格 (复杂 ) 的 JavaScript 
代码 。Dojo 的 事件 系统 、IO 的 API 以 及 通用 语言 形式 是 基于 一 个 强大 编程 环境 。 

@ 通过 Dojo 提供 的 工具 ， 可 以 为 代码 写 命令 行 式 的 单元 测试 代码 。 

@ ”Dojo 的 扩展 包 能 够 使 代码 更 容易 维护 ， 耦 合 性 更 低 。 

3. 下 载 安装 Dojo 工 具 包 

使 用 Dojo 框架 ， 首 先 需要 下 载 它 的 工具 包 ， 下 面 介 绍 Dojo 的 下 载 与 安装 。 

1) 下 载 

打开 Dojo 的 官方 网 站 “http://download.dojotoolkit.org/”， 下 载 页面 如 图 13-9 所 示 。 


< 


司 呈 xx 
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13-9 ”Dojo 官 网 下 载 页 面 


下 载 最 新 版 本 1.5.0， 单 击 1.5.0 下 载 链接 ， 进 入 如 图 13-10 所 示 的 页 面 。 单 击 
dojo-release-1.5.0.zip 下 载 链接 ， 即 可 下 载 。 


Bl ix 
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人 


13-10 dojo-release-1.5.0.zip 下 载 页 面 


2) ”安装 

下 载 完 成 之 后 ， 解 压 dojo-release-1.5.0.zip 文件 ， 在 解压 后 的 dojo-release-1.5.0/dojo 目录 下 
可 以 找到 一 个 dojojs 文件 , 使 用 Dojo 只 需要 将 这 个 文件 复制 到 项 目的 相应 目录 中 的 即 可 使 用 ， 
如 : 在 项 目 WebRoot 目录 下 新 建 一 个 dojo 目录 ， 然 后 将 dojojjs 文件 复制 到 dojo 目录 下 。 


9 $》 在 Web 应 用 中 安装 好 Dojo 框架 后 ,如 果 在 页 面 使 用 该 框架 ,需要 添加 语句 :<script 


) 技巧 type="text/javascript" src="dojo/dojo.js"></script>。 


4. Dojo 常 用 函数 

1) dojo.connect 

dojo.connect 用 于 将 指定 的 事件 处 理 函 数 绑 定 到 事件 上 ， 也 可 以 绑 定 到 某 个 函数 上 ， 在 被 
绑 定 的 函数 执行 后 ， 指 定 的 函数 将 会 被 触发 执行 。dojo.connect 是 Dojo 的 最 主要 的 事件 处 理 及 
委托 方式 ， 它 可 接收 5 个 参数 。 

dojo.connect (obj, event, context, method, dontFix); 

@ obj: 事件 源 对 象 ， 或 被 绑 定 函数 的 作用 域 ， 默 认 值 (或 obj 被 设 为 nul) 为 dojo.global。 

@ event: 事件 名 或 被 绑 定 函数 名 ， 结 合 第 一 个 参数 ， 被 绑 定 事件 (或 函数 ) 会 被 指定 为 


obj[event]。 
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@ context: 事件 处 理 函 数 ( 绑 定 函数 ) 的 作用 域 。 默 认 值 (或 context 被 设 为 null) 为 
dojo.global。 

@ method: 事 件 处 理 函 数 ( 绑 定 函数 ) 的 名 称 或 是 函数 引用 , 如果 为 函数 名 称 , 结合 context 
参数 ， 该 函数 会 被 指定 为 context[method]。 这 个 函数 会 在 事件 或 绑 定 函数 执行 后 被 触 
发 。 该 函数 接收 的 参数 与 事件 或 被 绑 定 函数 的 参数 相同 。 

@ dontFix: 这 是 一 个 可 选 参数 ， 如 果 第 一 个 参数 obj 为 一 个 DOM 节点 对 象 ， 且 dontFix 
设 为 tue， 则 事件 处 理 不 会 委托 给 DOM 事件 管理 器 来 进行 分 发 。 

dojo.connect 的 具体 用 法 如 下 所 示 。 


// 当 obj .onchange () 执 行 后 ， 调 用 ui .update() : 
dojo.connect (obj, "onchange", ui, "update"); 


dojo.connect (obj, "onchange", ui, ui.update); 


dojo.connect 将 会 返回 一 个 handle 对 象 ,强烈 建议 你 在 代码 中 保存 这 些 handle 对 象 ， 
注意 | ”并 在 代码 进行 销毁 时 调用 dojo.disconnect 来 销毁 这 些 连接 ,否则 将 会 导致 内 存 泄露 。 


2) dojo.xhr 

dojo.xhr 并 不 是 一 个 函数 ，XHR 是 XMLHTTP request object (XMLHTTP 请 求 对 象 ) 的 一 个 
简写 。 但 Dojo 封装 了 一 系列 的 XHR 函数 用 于 Ajax 交互 ， 包 括 : dojo.xhrGet、dojo.xhrPost、 
dojo.xhrDelete、dojo.xhrPut、dojo.rawXhrPost、dojo.rawXhrPut 等 。 下 面 看 一 下 xhrGet 的 具体 
用 法 ， 如 下 所 示 。 


Var queryobj = {sort: "id"}; 
Var xhrHandler = dojo.xhrGet( 
urls "teatsjsp"r 
content: queryObj 
} 
上 
xhrHandler.addCallback (function(data){ 
datahandler (data); 
xhrHandler.addErrback (function (error){ 
errorHandler (error); 
I 


dojo.xhr* 接 收 一 个 JSON 对 象 作为 参数 , 该 参数 可 包括 众多 属性 , 以 下 列 出 一 些 重要 的 属性 。 
@ url: XHR 的 数据 请 求 接收 URL， 由 于 XHR 的 安全 限制 ， 该 URL 必须 与 脚本 处 于 相 


同 的 域 及 端口 下 。 
@ timeout: 超时 设 定 ， 单 位 为 ms， 当 等 待 时 间 超 过 给 定 值 ， 则 会 抛 出 一 个 错误 给 指定 
的 错误 处 理 回 调 函数 。 


@ sync: Boolean 值 ， 指 定 该 XHR 请 求 是 同步 或 是 异步 ， 默 认 值 为 false( 异 步 )。 
@ content: 一 个 JSON 对 象 ， 其 包含 的 键 值 对 ， 将 作为 请 求 参数 添加 到 URL 后 面 。 
下 面 来 看 一 下 它 的 具体 用 法 ， 如 下 所 示 。 


< 


I 22 Web 开发 学 习 实录 .入 


// 发 送 一 个 post 请 求 ， 并 忽略 response 
dojo.xhrPost ({ 

form: "someFormId"，// 在 发 送 Post 请 求 时 ， 请 求 数据 由 form 表单 ”someFormId” 

提供 ，URL 

// 可 以 通过 form 的 action 属性 获取 

timeout: 3000, 

content: { part:"one", another:"part" } ps 
creates ?part=oneg&another=part 
Ds 
// 获取 JSON 数据 
dojo.xhrGet ({ 

url:"data.json", 

handleAs:"json", 

load: function(data){ 

for(var i in data){ 
console.log("key", i, "value", datal[il]); 


} 
3 


3) dojo.subscribe 

dojo.subscribe 用 于 注册 函数 监听 某 个 被 发 布 的 频道 。 当 调用 dojo.publish 来 向 被 监听 的 频 
道 发 送 数 据 时 ， 被 注册 的 监听 函数 则 被 触发 ， 接 收发 送 的 数据 作为 参数 。 它 的 语法 格式 如 下 。 

dojo.subscribe (channel, function); 


@ channel: 发 布 数 据 的 频道 。 
@ function: 注册 的 监听 函数 。 
dojo.subscribe 的 具体 用 法 如 下 所 示 。 
// 注册 监听 函数 ， 监 听 "/foo/bar/baz" 频 道 
dojo.subscribe("/foo/bar/baz", function(data){ 
console.log("i got", data); 
Fa 
// 当 想 触发 被 注册 的 监听 函数 时 ， 调 用 dojo.publish 向 "/foo/bar/baz" 频 道 发 送 数据 
dojo.publish("/foo/bar/baz", [{ some:"object data" }]); 


// 这 些 频道 的 名 字 可 以 为 任意 定义 的 字符 串 


dojo.subscribe("foo-bar"，function (data){ /* handle */ }); 


4) dojo.connectPublisher 
dojo.connectPublisher 用 于 绑 定 某 些 事件 ， 以 便 自 动向 指定 的 频道 发 布 数据 。 它 的 语法 格式 
如 下 。 


dojo.connectPublisher (channel, object, event); 


@ channel: 发 布 数据 的 频道 。 
@ ”object: 事件 源 对 象 ， 或 被 绑 定 函数 的 作用 域 。 
@ event: 绑 定 事件 的 名 称 。 
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dojo.connectPublisher 的 具体 用 法 如 下 所 示 。 


dojo.connectPublisher("/some/topic/name",myObject, "myEvent") 


13.3.2 ”实例 描述 


通过 前 面 的 学 习 ， 相 信 读 者 已 经 感觉 到 Ajax 技术 确实 给 用 户 带 来 了 很 好 的 体验 ， 下 面 将 
看 看 另 一 个 秘密 武器 一 一 Dojo 框架 , 它 是 一 个 基于 客户 端的 框架 , 对 各 种 浏览 器 都 提供 了 很 好 
的 支持 。 利 用 Dojo， 可 以 很 容易 地 为 网 页 或 其 他 任何 支持 JavaScript 的 环境 增加 动态 能 力 。 比 
如 ， 异 步 获 取 一 些 数据 信息 。 本 节 实 例 将 展示 异步 获取 用 户 信息 这 一 功能 。 


13.3.3 ”实例 应 用 


【 例 13-3】 Dojo 异步 获取 用 户 信息 。 
(1) 在 项 目 src/com/pojo 目录 下 ， 新 建 一 个 User 实体 类 ， 声 明 id、name、email 和 address 
属性 ， 并 分 别 给 出 它们 的 get 和 set 方法 ， 代 码 如 下 所 示 。 


package com.pojo; 


public class User { 
private int id; // 编 号 
private string name; // 姓 名 
private String email;  // 电 子 邮 件 
private String address; // 家 庭 住址 


// 下 面 是 id、name、email 和 address 属性 的 get 和 set 方法 ， 在 此 省 略 了 。 


| 


(2) 新 建 一 个 JSP 页 面 dojojsp, 在 该 页 面 中 使 用 dojo.xhrGetO 函 数 从 getUserjsp 页 面 中 获 
取 用 户 信息 ， 代 码 如 下 所 示 。 

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 

<%@ taglib prefix="s" uri="/struts-tags" 和 > 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 


<html> 
<head> 
<title>My JSP 'dojo.jsp' starting page</title> 
</head> 
<body> 
<h1>Dojo 框架 异步 通信 </h1><br/> 
<div id="showDate"></div><br/> 
<input type="button" value=" 获 取 用 户 信 息 " onclick="getUser()"/> 
<script type="text/javascript" src="dojo/dojo.js"></script> <!-- 引 
用 Dojo 框架 --> 


<script type="text/javascript"> 


< 
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function getUser(){ // 按 钮 单 击 事件 调用 函数 
dojo.xhrGet( 
{ 
url:"getUser.jsp", // 指 定 请 求 链接 
load:returnDate, // 指 定 回 调 函 数 
error:dealError // 指 定 错误 处 理 函数 


} 
function returnDate (data,ioArgs){ // 回 调 函数 

document .getElementById ("showDate") .innerHTML = data; 
} 


function dealError (data,ioArgs){ // 错 误 处 理 函 数 
document .getElementBYId("showDate") .innerHTML = "服务 器 访问 失 
Lp 
} 
</script> 
</body> 
</html> 


(3) 新 建 一 个 JSP 页 面 getUserjsp， 在 该 页 面 中 使 用 <s:bean> 标 签 引 入 实体 类 User 对 象 ， 
并 对 其 属性 赋值 ， 再 使 用 <s:property> 标 签 输出 用 户 信息 数据 ， 代 码 如 下 所 示 。 

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 

<%@ taglib uri="/struts-tags" prefix="s" %> 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 


<html> 
<head> 
<title> 显 示 用 户 信息 </title> 
</head> 
<body> 
<s:bean name="com.pojo.User" id="user"> 
<s:param name="name" value="' 刘 晓 波 '"/> 
<s:param name="email" value="'liuxiaobo@sina.cn'"/> 
<s:param name="address" value="' 浙 江 绍 兴 '"></s:param> 
</s:bean> 
<p> 
姓名 : <s:property value="#user.name"/><br/> 
电子 邮件 : <s:property value="#user.email"/><br/> 
家 庭 住 址 : <s:property value="#user.address"/> 
</p> 
</body> 
</html> 


13.3.4 运行 结果 


运行 实例 ， 打 开 正 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_13/dojojsp”， 
进入 显示 用 户 信息 页 面 ， 单 击 “ 获 取 用 户 信息 ”按钮 ， 可 以 获取 用 户 信息 并 显示 在 页 面 上 ， 执 


> 
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行 效 果 如 图 13-11 所 示 。 


图 13-11 Dojo 异 步 获 取 用 户 信息 


13.3.5 ”实例 分 析 


让 


本 实例 首先 创建 一 个 User 用 户 实 体 类 ， 上 声明 了 id、name、email 和 address 属性 ， 然 后 新 
建 了 一 个 JSP 页 面 dojo.jsp， 在 该 页 面 中 添加 了 一 个 “获取 用 户 信息 ”按钮 ， 为 该 按钮 添加 了 
一 个 onclick 鼠标 单 击 事件 ,触发 执行 getUser( 函 数 , 该 函数 使 用 dojo.xhrGet() 函 数 从 getUser.jsp 
页 面 中 获取 用 户 信息 。 最 后 新 建 getUser.jsp 页 面 ， 在 该 页 面 中 使 用 <s:bean> 标 签 实例 化 User 
实体 类 ， 使 用 <s:param> 标 签 为 User 对 象 属性 赋值 ， 并 使 用 <s:property> 标 签 在 页 面 中 输出 显示 
User 对 象 属性 值 。 


13.4 Ajax 的 异步 请 求 来 获取 服务 端 数据 


鉴于 Ajax 的 强大 交互 功能 ， 对 于 一 个 成 功 的 Web 框架 来 说 ， 简 易 的 Ajax 集成 是 不 可 或 
缺 的 。Struts 2 作为 一 款 优秀 的 基于 MVC 的 Java Web 框架 ， 提 供 了 比较 完善 的 Ajax 的 支持 。 
前 面 已 经 介绍 了 Struts 2 对 两 个 比较 成 熟 的 Ajax 框架 (Dojo 和 DWR) 的 支持 , 另外 Struts 2 还 提 
供 了 一 系列 常用 的 Ajax 标签 ， 使 Ajax 开发 更 简便 。 


ce 视频 教学 : 光盘 /videos/13/ajax.avi 生长 度 : 8 分 钟 
光盘 /videos/13/a.avi 生长 度 : 9 分 钟 
光盘 /videos/13/divl.avi 生长 度 : 13 分 钟 
光盘 /videos/13/div2.avi 生长 度 : 9 分 钟 
光盘 /videos/13/tabbedPanel.avi 生长 度 : 6 分 钟 
光盘 /videos/13/autocompleter.avi 全 长 度 : 11 分 钟 


13.4.1 基础 知识 一 一 Struts 2 的 Ajax 标签 
Struts 2 提供 的 一 些 常用 Ajax 标签 可 以 满足 普通 的 Ajax 需要 ， 比 如 : div 标签 、submit 标 
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签 、a 标签 ， 等 等 。 本 节 将 详细 讲解 这 些 标签 的 使 用 。 


1. div 标 签 


div 标签 指 <s:div> 标 签 ， 它 可 以 在 页 面 中 生成 一 个 div 元 素 ， 但 它 生 成 的 div 元 素 与 我 们 
以 往 使 用 的 div 元 素 不 同 的 是 ， 这 里 的 div 标签 的 内 容 是 通过 Ajax 的 异步 请 求 来 获取 的 ， 以 实 
现 局 部 内 容 的 刷新 。 


1) ”div 标签 属性 


首先 介绍 一 下 div 标签 的 主要 属性 ， 如 表 13-1 所 示 。 


表 13-1 div 标签 的 属性 
名 _ 称 说 明 
afterLoading 指定 获取 内 容 后 需要 执行 的 JavaScript 代码 
afterNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 成 功 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 
autoStart 指定 页 面 加 载 后 是 否 自动 启动 定时 器 


beforeNotifyTopics 指定 在 请 求 之 前 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 


closable 


delay 


指定 当 使 用 div 标签 作为 选项 卡 的 一 个 Tab 页 面 时 ， 是 否 显示 关闭 按钮 

指定 更 新 内 容 的 时 间 延 迟 ， 单 位 为 ms。 如 果 不 指 定 此 属性 ， 则 页 面 在 加 载 后 就 
获取 数据 。 如 果 指定 此 属性 ， 同 时 也 指定 updateFreq 属性 ， 则 页 面 加载 后 需要 
先 度 过 延迟 时 间 ， 然 后 获取 数据 (延迟 效果 不 会 超出 更 新 时 间 )， 如 果 没有 指定 
updateFreq 属性 ， 则 此 属性 无 实际 意义 


errorNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 失败 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 


errorText 指定 获取 数据 发 生 错误 时 的 提示 信息 

executeScripts 指定 是 否 在 本 页 面 执行 服务 器 响应 的 JavaScript 脚本 代码 ， 其 默认 值 为 false 
formFilter 指定 过 滤 表 单字 段 的 函数 

formld 指定 表单 的 It， 表单 的 字段 将 被 序列 化 并 作为 参数 传递 


handler 


指定 本 页 面 的 脚本 函数 作为 处 理 函 数 。 如 果 指 定 了 此 属性 ， 则 不 会 向 服务 器 发 


送 Ajax 请 求 


highlightColor 指定 突出 显示 颜色 ， 对 targets 属性 所 指定 的 元 素 进行 突出 显示 
en 指定 targets 所 指定 元 素 进行 突出 的 持续 时 间 ， 单 位 为 ms。 如 果 highlightColor 
属性 无 值 ， 此 属性 无 效 
href 指定 动态 获取 服务 器 端 数 据 的 URL 
indicator 指定 动态 加 载 服务 器 端 数据 过 程 中 的 显示 内 容 ， 这 里 一 般 指定 图 标 
_javascriptIooltip 指定 是 否 使 用 JavaScript 生成 浮动 提示 框 
listenTopics 指定 触发 远程 调用 的 话题 
指定 当 处 理 正在 处 理 时 显示 的 文本 ， 如 果 异 步 请 求 发 生 错误 则 错误 信息 将 显示 
loadingText 在 div 内 容 中 ， 如 果 不 想 显示 错误 信息 ， 可 以 将 showErrorTransportText 属性 设 
置 为 flse， 如 果 想 定制 这 个 错误 消息 ， 可 以 使 用 errorText 属性 
指定 在 请 求 之 前 、 请 求 之 后 以 及 发 生 错误 时 发 表 的 话题 清单 ， 话 题 之 间 使 用 “.” 
notifyTopics 


sm >> 
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©. 
续 表 
名 称 说 了 明 
openTemplate 打开 HTML 文件 的 显示 模板 
parseContent 指定 是 否 分 析 返 回 的 动态 Web 内 容 以 寻找 组 件 
preload 指定 是 否 在 加 载 页 面 的 同时 加 载 动态 Web 内 容 
et 指定 是 否 需 要 在 div 元 素 变 得 可 见 时 加 载 动 态 Web 内 容 。 此 属性 在 div 元 素 包 
含 于 tabbedpanel 元 素 中 时 有 效 
separateScripts 指定 是 否 需 要 为 每 个 标签 单独 创建 一 个 范围 来 运行 脚本 代码 
showErrorTransportText 指定 是 否 显 示 错误 信息 
showLoadingText 指定 是 否 在 装载 内 容 时 显示 提示 信息 
ee 指定 一 个 监听 的 事件 主题 ， 当 Struts 2 组 件 向 该 主题 发 布 事件 时 ，div 标签 的 计 
时 器 自动 启动 
sre 指定 一 个 监听 的 事件 主题 ， 当 Struts 2 组 件 向 该 主题 发 布 事 件 时 ，div 标签 的 计 
stopTimerListenTopics 时 器 自动 停止 
transport 用 来 传递 相关 请 求 参 数 的 传输 对 象 
指定 内 容 的 更 新 时 间 间 隔 ， 单 位 为 ms。 如 果 不 指 定 此 属性 ， 则 内 容 只 有 在 页 面 
updateFreq 加 载 时 才 会 更 新 
refreshListenTopic 指定 主题 名 ， 当 该 主题 事件 发 布 时 ，div 内 容 将 重 载 


2) div 标签 应 用 


通过 上 面 的 学 习 ， 读 者 对 div 标签 的 属性 有 了 基本 的 了 解 ， 下 面 运用 一 个 小 例子 来 帮助 读 
者 对 div 标签 属性 应 用 的 理解 。 
(1) 首先 看 一 个 DateAction， 声 明 一 个 date 属性 ， 并 重 写 ActionSupport 的 execute() 方 法 ， 
用 于 获取 系统 当前 时 间 ， 代 码 如 下 所 示 。 
public class DateAction extends ActionSupport{ 
private Date date; 


public Date getDate() { 
return date; 


; 


public void setDate (Date date) { 
this.date = date; 


} 


public String execute() throws Exception 


{ 


date = new Date(); 
return SUCCESS; 


} 


< 
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(2) 编写 完 DateAction 之 后 ， 还 需要 在 stmts .xml 文件 中 ， 添 加 入 它 的 配置 信息 ， 代 码 如 
下 所 示 。 


<package name="div" extends="struts-default"> 
<action name="date" class="com.gdupt.action.DateAction"> 
<result>/showDate.jsp</result> 
</action> 
</package> 


(3) 然后 ,在 项 目 中 新 建 一 个 JSP 页 面 showDate.jsp, 用 于 显示 当前 系统 时 间 , 当 DateAction 
执行 成 功 之 后 将 跳 转 到 该 页 面 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"$%> 
<%@ taglib uri="/struts-tags" prefix="s" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head></head> 
<body> 
服务 器 的 当前 时 间 为 : <font color="red"> 
<s:date name="date" format="yyyy-MM-dd HH:mm:ss"/></font> 
</body> 
</html> 


(4) 最 后 ， 在 项 目 中 新 建 一 个 JSP 页 面 divjsp， 通 过 为 div 标签 指定 hre 伍 "%{date}"。 其 
中 date 是 某 个 url 标签 的 id 属性 值 ， 该 ul 标签 的 value 属性 值 指定 了 获取 数据 的 DateAction。 
使 用 div 标签 动态 从 服务 器 端 获取 数据 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<%@ taglib prefix="s" uri="/struts-tags" %> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title>struts 2 ajax s:div</title> 
<s:head theme="ajax"/> 
</head> 
<body> 
<center> 
<br/><br/> 
<h5 style="color: red;">struts2 s:div 实现 AJAX 效果 </h5> 
<br/> 
<s:url id="T" value="date.action" /> 
在 页 面 加 载 时 获取 数据 : 
<s:div id="norefresh" theme="ajax" href="%{T}"></s:div> 
每 2 秒 钟 刷新 一 次 
<s:div id="refresh" theme="ajax" href="%{T}" 
updateFreq="2000"></s:div> 
每 5 秒 钟 刷新 一 次 ， 但 有 2 秒 延 迟 
<s:div name="refreshD" theme="ajax" href="%{T}" updateFreq="5000" 
delay="2000"/> 
</center> 
</body> 
</html> 
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运行 程序 ， 打 开 IE 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2_13/divjsp”， 
执行 效果 如 图 13-12 所 示 。 
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struts2 s:div 实 现 AJAX 并 村 


图 13-12 ”获取 系统 当前 时 间 
从 图 13-5 中 可 以 看 出 第 一 个 div 元 素 与 第 二 个 div 元 素 的 时 间 相 差 2 秒 钟 , 因为 第 一 个 div 
元 素 没有 设置 updateFreq 属性 进行 刷新 ， 而 第 二 个 div 元 素 是 每 2 秒 钟 刷新 一 次 。 第 3 个 div 
元 素 由 于 设置 了 delay 属性 ， 添 加 了 时 间 延 迟 效果 ， 还 没有 获取 到 服务 器 端 数据 。 
2. submit 标 签 
submit 标签 即 <s:submit> 标 签 ， 它 用 于 向 服务 器 异步 提交 数据 ， 也 可 以 使 用 异步 请 求 返 回 
的 文本 来 更 新 HTML 元 素 ( 通 常 指 div) 的 内 容 。 
1) submit 标签 属性 
submit 标签 的 常用 属性 如 表 13-2 所 示 。 
表 13-2 ” submit 标签 的 属性 


名 称 说 明 

errorText 指定 获取 数据 发 生 错 误 时 的 提示 信息 

executeScripts 指定 是 否 在 本 页 面 执行 服务 器 响应 的 JavaScript 脚本 代码 , 其 默认 值 为 false 

formFilter 指定 过 滤 表 单字 段 的 函数 

formld 指定 请 求 参数 的 表单 

afterNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 成 功 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “.” 分 开 

A 指定 如 果 验 证 成 功 ， 是 否 发 出 一 个 异步 请 求 。 此 属性 只 在 validation 属性 值 
为 true 时 有 效 

beforeNotifyTopics 指定 在 请 求 之 前 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 

errorNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 失败 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “.” 分 开 

a 指定 本 页 面 的 脚本 函数 作为 处 理 函数 。 如 果 指 定 了 此 属性 ， 则 不 会 向 服务 
器 发 送 Ajax 请 求 

highlightColor 指定 突出 显示 颜色 ， 对 targets 属性 所 指定 的 元 素 进行 突出 显示 


< 
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续 表 
名 称 说 明 
a 指定 targets 所 指定 元 素 进行 突出 的 持续 时 间 , 单 位 为 ms。 如 果 highlightColor 
属性 无 值 ， 此 属性 无 效 
href 指定 动态 获取 服务 器 端 数据 的 URL 
indicator 指定 动态 加 载 服 务 器 端 数据 过 程 中 的 显示 内 容 ， 这 里 一 般 指定 图 标 
javascriptTooltip 指定 是 否 使 用 JavaScript 生成 浮动 提示 框 
listenTopics 指定 触发 远程 调用 的 话题 
loadingText 指定 内 容 正在 装载 过 程 中 的 提示 信息 ， 主 要 用 来 提示 用 户 正 在 装载 内 容 
method 对 应 HTML submit 元 素 的 method 属性 
指定 在 请 求 之 前 、 请 求 之 后 以 及 发 生 错 误 时 发 表 的 话题 清单 ， 话 题 之 间 使 
notifyTopics 用 “.” 分 开 
parseContent 指定 是 否 分 析 返 回 的 动态 Web 内 容 以 寻找 组 件 
separateScripts 指定 是 否 需 要 为 每 个 标签 单独 创建 一 个 范围 来 运行 脚本 代码 
showErrorTransportText 指定 是 否 显示 错误 信息 
showLoadingText 指定 是 否 在 装载 内 容 时 显示 提示 信息 
BY 指定 当 按钮 类 型 为 Image 时 ， 按 钮 的 图 片 来 源 
targets 指定 内 容 将 被 更 新 的 元 素 清单 ， 元 素 之 间 使 用 “.” 分 开 
transport 指定 用 来 传递 相关 请 求 的 传输 对 象 
type 指定 提交 按钮 的 类 型 ， 可 选 值 有 : input、image 和 button 
validate 指定 是 否 进行 Ajax 验证 


2) submit 标签 应 用 
下 面 是 一 个 submit 标签 应 用 的 例子 ， 通 过 href 属性 来 指定 要 异步 请 求 的 资源 地 址 ， 通 过 
targets 属性 来 指定 服务 器 返回 的 响应 内 容 应 该 更 新 哪些 HTML 元 素 的 内 容 ， 代 码 如 下 所 示 。 
<div id="divdate"> 这 里 是 初始 内 容 </div> 
<s:url id="date" value="date.action" /> 
<br/> 
<s:submit type="submit" theme="ajax" href="%{date}" targets="divdate" 


align="]left™" 


value=" 更 新 指定 元 素 的 内 容 "></s:submit> 


3. a 标签 
a 标签 即 <s:a> 标 签 ， 用 来 生成 一 个 超 链接 ， 向 服务 器 异步 提交 数据 ， 并 将 返回 内 容 加 载 到 
指定 页 面 元 素 中 。 


1) a 标签 属性 
a 标签 的 常用 属性 如 表 13-3 所 示 。 
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表 13-3 a 标签 的 属性 


名 称 说 明 
afterNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 成 功 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 
二 指定 如 果 验 证 成 功 ， 是 否 发 出 一 个 异步 请 求 。 此 属性 只 在 validation 属性 值 

ajaxAfterValidation 
为 tme 时 有 效 

beforeNotifyTopics 指定 在 请 求 之 前 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 

errorNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 失败 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 

errorText 指定 获取 数据 发 生 错误 时 的 提示 信息 

executeScripts 指定 是 否 在 本 页 面 执行 服务 器 响应 的 JavaScript 脚本 代码 , 其 默认 值 为 false 

formFilter 指定 过 滤 表 单字 段 的 函数 

formId 指定 请 求 参 数 的 表单 

PE 指定 本 页 面 的 脚本 函数 作为 处 理 函 数 。 如 果 指 定 了 此 属性 ， 则 不 会 向 服务 
器 发 送 Ajax 请 求 

highlightColor 指定 突出 显示 颜色 ， 对 targets 属性 所 指定 的 元 素 进行 突出 显示 

ee 指定 targets 所 指定 元 素 进行 突出 的 持续 时 间 , 单 位 为 ms。 如 果 highlightColor 
属性 无 值 ， 此 属性 无 效 

href 指定 动态 获取 服务 器 端 数据 的 URL 

indicator 指定 动态 加 载 服 务 器 端 数据 过 程 中 的 显示 内 容 ， 这 里 一 般 指 定 图 标 

javascriptTooltip 指定 是 否 使 用 JavaScript 生成 浮动 提示 框 

listenTopics 指定 触发 远程 调用 的 话题 

loadingText 指定 内 容 正 在 装载 过 程 中 的 提示 信息 ， 主 要 用 来 提示 用 户 正 在 装载 内 容 
指定 在 请 求 之 前 、 请 求 之 后 以 及 发 生 错误 时 发 表 的 话题 清单 ， 话 题 之 间 使 

notifyTopics 
用 下 全 闪 天 

openTemplate 用 来 打开 HTML 文件 的 显示 模式 

parseContent 指定 是 否 分 析 返 回 的 动态 Web 内 容 以 寻找 组 件 

separateScripts 指定 是 否 需要 为 每 个 标签 单独 创建 一 个 范围 来 运行 脚本 代码 

showErrorTransportText 指定 是 否 显示 错误 信息 

showLoadingText 指定 是 否 在 装载 内 容 时 显示 提示 信息 

targets 指定 内 容 将 被 更 新 的 元 素 清单 ， 元 素 之 间 使 用 “.” 分 开 

transport 指定 用 来 传递 相关 请 求 的 传输 对 象 

validate 指定 是 否 进行 Ajax 验证 


2) a 标签 应 用 


前 面 已 经 说 过 a 标签 用 于 生成 一 个 超 链接 ， 下 面 就 使 用 a 标签 来 获取 系统 当前 时 间 ， 设 置 
href 属性 来 指定 要 异步 请 求 的 资源 地 址 ，targets 属性 来 指定 服务 器 返回 的 响应 内 容 应 该 更 新 哪 
些 HIML 元 素 的 内 容 。 代 码 如 下 所 示 。 

<s:url id="date" value="date.action" /> 

<div id="divdate"></div> 


< 
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<br/> 


<s:a id="al" theme="ajax" href="%{date}" targets="divdate"> 


单 击 此 链接 ， 从 服务 器 端 获取 数据 ， 更 新 id 为 aivdate 的 div 元 素 内 容 </s:a> 


4. tabbedPanel 标 签 


tabbedPanel 标签 即 <s:tabbedPanel> 标 签 ， 用 于 生成 一 个 Panel( 包 含 标签 页 tab)，tab 页 上 的 
内 容 可 以 是 静态 的 也 可 以 是 动态 异步 加 载 的 。 每 个 标签 页 都 是 一 个 Ajax 主题 下 的 div 标签 , 因 
此 作为 标签 页 使 用 的 div 标签 只 能 在 tabbedPanel 标签 的 内 部 使 用 , 还 需要 使 用 div 标签 的 label 
属性 来 制定 标签 页 的 标题 。 


1) 


tabbedPanel 标签 


tabbedPanel 标签 的 常用 属性 如 表 13-4 所 示 。 


表 13-4 tabbedPanel 标 签 的 常用 属性 


名 称 说 明 

et 指定 如 果 验 证 成 功 ， 是 否 发 出 一 个 异步 请 求 。 此 属性 只 在 validation 属性 值 为 rue 
时 有 效 

beforeNotifyTopics 指定 在 请 求 之 前 发 表 的 话题 清单 ， 话 题 之 间 使 用 “.” 分 开 

closeButton 指定 Tab 页 面 上 关闭 按钮 的 位 置 ， 可 选 值 有 tab 和 pane 

本 指定 tabbedPanel 是 否 为 固定 高 度 ， 如 果 此 属性 值 为 false， 则 其 高 度 随 着 Tab 页 面 
的 大 小 而 改变 

errorNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 失败 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 

errorText 指定 获取 数据 发 生 错 误 时 的 提示 信息 

executeScripts 指定 是 否 在 本 页 面 执行 服务 器 响应 的 JavaScript 脚本 代码 ， 其 默认 值 为 false 

formFilter 指定 过 滤 表 单字 段 的 函数 

formId 指定 请 求 参数 的 表单 

指定 本 页 面 的 脚本 函数 作为 处 理 函数 。 如 果 指 定 了 此 属性 ， 则 不 会 向 服务 器 发 送 
Ajax 请 求 

href 指定 动态 获取 服务 器 端 数据 的 URL 

indicator 指定 动态 加 载 服务 器 端 数据 过 程 中 的 显示 内 容 ， 这 里 一 般 指定 图 标 

labelposition 指定 Tab 页 面 中 标签 的 位 置 ， 可 选 值 有 : top( 默 认 值 )、right、bottom 和 left 

loadingText 指定 内 容 正 在 装载 过 程 中 的 提示 信息 ， 主 要 用 来 提示 用 户 正 在 装载 内 容 

method 对 应 HTML submit 元 素 的 method 属性 

selectedTab 指定 加 载 该 页 面 时 ， 初 始 状 态 下 显示 哪个 Tab 页 面 ， 默 认 显示 第 一 个 

showErrorTransportText | 指定 是 否 显示 错误 信息 

showLoadineText 指定 是 否 在 装载 内 容 时 显示 提示 信息 

targets 指定 内 容 将 被 更 新 的 元 素 清单 ， 元 素 之 间 使 用 “.” 分 开 

transport 指定 用 来 传递 相关 请 求 的 传输 对 象 

validate 指定 是 否 进行 Ajax 验证 
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@' 一 定 要 将 tabbedPanel 标签 的 theme 属性 设置 为 simple 主题 ， 不 要 设置 为 ajax， 因 
注意 为 tabbedPanel 标签 在 simple 主题 中 ， 本 身 没 有 包含 任何 的 Ajax 功能 ， 但 是 div 
标签 的 属性 一 定 要 设置 为 ajax。 


2) ”tabbedPanel 标签 的 应 用 
使 用 tabbedPanel 标签 实现 一 个 静态 标签 页 ， 代 码 如 下 所 示 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"$%> 
<%@ taglib prefix="s" uri="/struts-tags" $%> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 
<head> 
<title> 我 的 静态 Tab 页 实例 </title> 
<s:head theme="ajax" debug="true"/> 
<link rel="stylesheet" type="text/css" href="<s:url 
value="/struts/tabs.css"/>"> 
</head> 
<body> 
<s:tabbedPanel id="mystatic" theme="simple" 
cssSstyle="width:300px;height:200px;"> 
<s:div id="staticl" label="Tab 1" theme="ajax"> 
我 的 第 一 个 静态 标签 页 
</s:div> 
<s:div id="static2" label="Tab 2" theme="ajax"> 
我 的 第 二 个 静态 标签 页 
</s:div> 
</s:tabbedPanel> 
</body> 
</html> 


5. autocompleter 标 签 
autocompleter 标签 指 <s:autocompleter> 标 签 ， 用 来 在 页 面 中 生成 一 个 带 下 拉 按 钮 的 单行 文 


本 框 。 在 页 面 加 载 时 ， 生 成 像 搜索 引擎 一 样 的 自动 向 用 户 提示 一 些 关键 字 选 项 。 下 拉 列 表 用 来 


向 用 


户 显示 输入 提示 ， 提 供 可 选 值 ， 它 的 可 选 值 会 随 着 用 户 在 文本 框 中 的 输入 内 容 的 改变 来 给 


出 建议 性 选项 ， 当 然 ， 可 选 值 在 页 面 加 载 时 生成 的 内 容 范 围 之 内 。 


@' 一 定 要 将 tabbedPanel 标签 的 theme 属性 设置 为 simple 主题 ， 不 要 设置 为 ajax， 因 
注意 为 tabbedPanel 标签 在 simple 主题 中 ， 本 身 没有 包含 任何 的 Ajax 功能 ， 但 是 div 
标签 的 属性 一 定 要 设置 为 ajax。 
1) ”autocompleter 标签 
autocompleter 标签 的 常用 属性 如 表 13-5 所 示 。 


< 


Seputs 2 Web 开发 学 习 实录 . 


名 称 


表 13-5 ”autocompleter 标 签 的 属性 


说 明 


afterNotifyTopics 


指定 在 请 求 之 后 (如 果 请 求 成 功 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “.” 分 开 


autoComplete 指定 是 否 在 单行 文本 框 中 显示 输入 提示 

beforeNotifyTopics 指定 在 请 求 之 前 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 
dataFieldName 被 返回 的 JSON 对 象 里 ， 包 含 着 数据 数组 的 那个 字段 的 名 字 
delay 指定 搜索 可 选 值 之 前 的 延迟 时 间 ， 单 位 为 ms 

dropdownHei 指定 下 拉 列 表 的 高 度 

dropdownWidth 指定 下 拉 列 表 的 宽度 ， 默 认 与 单行 文本 框 一 致 

emptyOption 指定 是 否 插入 一 个 空 选项 

errorNotifyTopics 指定 在 请 求 之 后 (如 果 请 求 失败 ) 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 分 开 
forceValidOpion 指定 单行 文本 框 是 否 接受 下 拉 列 表 中 的 选项 

formFilter 指定 过 滤 表 单字 段 的 函数 

formld 指定 请 求 参 数 的 表单 

headerKey 指定 选项 清单 里 的 第 一 项 的 键 

headerValue 指定 选项 清单 里 的 第 一 项 的 值 

href 指定 动态 获取 服务 器 端 数据 的 URL 

iconPath 指定 下 拉 列 表 的 图 标 文件 路 径 

indicator 指定 动态 加 载 服务 器 端 数据 过 程 中 的 显示 内 容 ， 这 里 一 般 指定 图 标 
javascriptTooltip 指定 是 否 使 用 JavaScript 生成 浮动 提示 框 

keyName 指定 将 被 选中 的 键 赋 给 哪 一 个 属性 

list 指定 生成 下 拉 列 表 中 选项 的 集合 

listKey 指定 列表 中 用 来 提供 选项 标号 的 对 象 的 属性 

listValue 指定 列表 中 用 来 提供 选项 值 的 对 象 的 属性 

listenTopics 指定 触发 远程 调用 的 话题 


loadMinimumCount 


当 loadOnTextChange 属性 值 为 true 时 ， 用 来 指定 输入 多 少 字符 后 ， 才 会 重新 加 载 
下 拉 列 表 的 选项 


loadOnTextChange 指定 在 单行 文本 框 中 的 内 容 发 生 改 变 时 ， 是 否 需 要 重新 加 载 列表 选项 
maxLength 对 应 HTML maxlength 属性 
、 指定 在 请 求 之 前 、 请 求 之 后 以 及 发 生 错 误 时 发 表 的 话题 清单 ， 话 题 之 间 使 用 “,” 

notifyTopics 分 开 

preload 指定 是 否 在 加 载 页 面 的 同时 重新 加 载 清 单 

TesultsLimit 指定 选项 最 多 可 以 有 多 少 个 ， 如 果 此 属性 值 为 -1， 表 示 无 限制 
指定 下 拉 列 表 与 单行 文本 框 的 字符 匹配 模式 ， 可 选 值 有 : startstring( 默 认 值 ， 显 示 

searchType 以 文本 框 中 字符 串 开头 的 选项 )、startword( 显 示 以 文本 框 中 单词 开头 的 选项 ) 和 
substring( 显 示 包 含 文本 框 中 字符 串 的 选项 ) 

showDownArrowW、 指定 是 否 显示 下 拉 箭 头 ， 其 默认 值 为 tue 

transport 指定 用 来 传递 相关 请 求 的 传输 对 象 


ValueNotifyTobics 指定 在 有 一 个 值 被 选中 时 发 表 的 话题 清单 ， 话 题 之 间 使 用 “.” 分 开 
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2) ”autocompleter 标签 的 应 用 

学 习 了 autocompleter 标签 属性 之 后 , 来 看 看 它 的 具体 应 用 , 即 实现 一 个 选择 自己 喜欢 的 水 
果 的 小 实例 ， 代 码 如 下 所 示 。 

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 


<%@ taglib prefix="s" uri="/struts-tags" %> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 


<html> 

<head> 
<title>autocompleter 标签 示例 </title> 
<s:head theme="ajax" debug="true"/> 

</head> 

<body> 
从 服务 器 端 获取 数据 : <s:url id="data" value="data.action" /> 
选择 自己 喜欢 的 水 果 : 
<s:autocompleter name="auto" theme="ajax" href="%{data}"/><br/> 
<hr/> 
设置 showDownArrow="false"<br/> 
选择 自己 喜欢 的 水 果 : 


<s:autocompleter name="auto" theme="ajax" href="%{data}" 
showDownArrow="false"/><br/> 
<hr/> 
设置 1ist 属性 获取 本 地 List 数据 <br/> 
选择 喜爱 的 节日 : 
<s:autocompleter name="auto" theme="simple" 
list="{' 春 节 ',' 端 午 节 ',' 中 秋 节 ', ' 七 夕 节 ' }"/><br/> 
<hr/> 
</body> 
</html> 


动态 的 从 服务 器 端 获取 数据 ， 需 要 在 struts.xml 文件 中 配置 一 个 Action， 该 Action 返回 
fruitjs 文件 中 的 JSON 格式 的 数据 ， 配 置 代 码 如 下 所 示 。 


<package name="autocompleter" extends="struts-default"> 
<action name="data"> 
<result>/fruit.js</result> 
</action> 
</package> 


fruitjs 文件 中 的 JSON 格式 数据 ， 如 下 所 示 。 


[ 
[" 蜜 桔 ", " 蜜 "]， 
[" 检 子 "," 枪 "1; 
[" 杨 梅 ", " 杨 "]， 
[" 蕴 果 "," 苹 "]， 
下 你 2 
[" 柠 檬 "，" 柠 "] 


怀 人 mm 
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13.4.2 ”实例 描述 


Ajax 的 异步 获取 信息 给 用 户 浏览 页 面 带 来 了 很 好 的 体验 ， 同 时 Struts 2 提供 的 一 些 Ajax 


标签 也 可 以 进行 异步 获取 数据 操作 。 本 节 实 例 将 为 读者 演示 Ajax 的 具体 实现 ， 即 异步 获取 服 
务 器 端的 数据 。 


13.4.3 ”实例 应 用 


【 例 13-4】 Ajax 的 异步 请 求 来 获取 服务 端 数据 。 
(1) 在 项 目 src/comy/struts2/action 包 下 新 建 一 个 RandomAction， 用 于 生成 一 个 随机 数 ， 代 


码 如 下 。 


package com.struts2.action; 
import com.opensymphony.xwork2.ActionSupport; 
public class RandomAction extends Actionsupport 
和 

Private String data; // 数 据 


public String getRdmstr(){ // 生 成 一 个 随机 数 
String result = String.valueOf (Math.round(Math.random() * 10000)); 
return data != null && !data.equals("") ? data + result : result; 


} 

public void setDatal(String data){ 
this.data = data; 

} 

public String getData(){ 
return this.data; 

3 

public String execute(){ 
return SUCCESS; 

} 

} 


(2) 打开 项 目 src 目录 下 的 struts.xml 文件 ， 添 加 RandomAction 的 配置 ， 代 码 如 下 所 示 。 


<package name="ajax tab" extends="struts-default"> 
<action name="random" class="com.struts2.action.RandomAction"> 
<result name="success">/random.jsp</result> 
</action> 
</package> 


(3) 新 建 一 个 JSP 页 面 random.jsp， 用 于 显示 RandomAction 产生 的 随机 数据 ， 代 码 如 下 


所 示 。 


<%@ page contentTyp 


="text/html;charset=UTF-8" language="java" $%> 
<%@ taglib prefix="s" uri="/struts-tags" %> 
< 


request.setAttribute ("decorator", "none"); 
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response.setHeader ("Cache-Control", "no-cache"); //HTTP 1.1 
response.setHeader ("Pragma", "no-cache"); //HTTP 1.0 
response.setDateHeader ("Expires", 0); //prevents caching at the proxy 

server 

%> 

服务 器 返回 的 随机 数字 是 : <s:property value="rdmstr"/> 


(4) 新 建 一 个 JSP 页 面 ajax_tabjsp， 在 该 页 面 中 从 服务 器 端 获取 RandomAction 生成 的 随 
机 数 ， 显 示 在 div 元 素 中 ， 通 过 指定 showErrorTransportText="true"， 可 以 在 div 元 素 中 显示 系 
统 出 错 提示 (如 : 本 实例 中 提示 Error loading 404 AjaxNoUrlLjsp)。 代 码 如 下 所 示 。 


<%@ page contentType="text/html;charset=UTF-8" language="java" $%> 
<%@ taglib prefix="s" uri="/struts-tags" $%> 
<html> 
<head> 
<title> 远 程 Div</title> 
<s:head theme="ajax"/> 
</head> 
<body> 
<s:url id="rd" value="random.action" /> 
仅 一 次 获取 服务 器 内 容 的 Div<br> 


<s:div i 


cssSstyle="border: lpx solid black;background-color:#dddddd; 
width:300px;height:40px;padding-top:8px;padding-left:20px" 
href="%{rd}"> 
初始 化 文本 
</s:div> 
动态 更 新 内 容 的 Div， 每 隔 1s 刷新 一 次 (通过 指定 updateFreq="1000") <br> 
使 用 indicator (通过 指定 indicator="indicator") <br> 
<s:div id="div2" 
theme="ajax" 
cssSstyle="border: lpx solid black;background-color:#dddddd; 
width:300px;height:40px;padding-top:8px;padding-left:20px" 
href="%{rd}" 
updateFreq="1000" 
indicator="indicator"> 
初始 化 文本 
</s:div> 
<img id="indicator" 
src="${pageContext.request.contextPath}/images/indicator.gif™ 
alt="Loading..." style="display:none"/><br> 
3s 之 后 才 开 始 更 新 (通过 指定 delay="3000") <br> 
指定 与 服务 器 交互 出 错 的 提示 (通过 指定 errorText 属性 ) <br> 
指定 与 服务 器 交互 过 程 中 的 提示 (通过 指定 loadText 属性 ) <br> 
<ondiy d= 
theme="ajax™ 
cssSstyle="border: lpx solid 
black;background-color:#dddddd;width:300px;height:40px;padding-top:8px;padd 
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ing—left:20px" 
href="%{rd}" updateFreq="1000" delay="3000"™ 
errorText=" 加 载 服务 器 数据 出 错 " 
loadingText=" 正 在 加 载 服 务 器 内 容 "> ”<!-- 使 用 变量 来 指定 URL--> 
初始 化 文本 
</s:div> 
指定 显示 系统 出 错 提示 (通过 指定 showErrorTransportText="true") <br> 
<s:div id="div4" 
theme="ajax" 
cssStyle="border: lpx solid black;background-color:#dddddd; 
width:300px;height:40px;padding-top:8px;padding-left:20px" 
href="/AjaxNoUrl.jsp" 
updateFreq="1000" 
showErrorTransportText="true" 
loadingText=" 正 在 加 载 服务 器 内 容 "> 
初始 化 文本 
</s:div> 
</body> 
</html> 


(5) 新 建 一 个 JSP 页 面 resultjsp, 在 该 页 面 中 采用 本 页 面 的 JavaScript 函数 获取 本 地 数据 ， 
不 再 调用 远程 服务 器 ， 代 码 如 下 所 示 。 
<%@ page contentType="text/html;charset=UTF-8" language="java" %> 
<%@ taglib prefix="s" uri="/struts-tags" %> 
<html> 
<head> 
<title> 远 程 Div</title> 
<s:head theme="ajax"/> 
</head> 
<script type="text/javascript"> 
function handler (widget, node) { 
alert (' 本 地 Javascript 函数 处 理 动态 Div'); 
node.innerHTML = Math.random() > 0.4 ? "spring2.0 宝典 " : 
" 轻 量 级 J2EE 企业 应 用 实战 "; 
</script> 
<body> 
<s:url id="rd" value="/random.action" /> 
直接 使 用 本 页 面 的 Js 函数 ， 不 再 调用 远程 服务 器 <br> 
<s:div id="divl" 
theme="ajax"™" 
cssSstyle="border: lpx solid black;background-color:#dddddd; 
width:300px;height:40px;padding-top:8px;padding-left:20px" 
href="%{rd}" updateFreq="2000"™ 
handler="handler"><!-- 此 时 的 href 属性 无 效 --> 
初始 化 文本 
</s:div> 
</body> 
</html> 
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13.4.4 ”运行 结果 


打开 正 浏览 器 ， 在 地 址 栏 中 输入 “http://localhost:8080/Struts2 13/ajax_tab.jsp”， 从 服务 
器 端 远程 获取 数据 ， 执 行 效 果 如 图 13-13 所 示 。 


x 
和 - 目 汪 二 -WO- F200- IAD- @- “| 


AJAX 的 异步 请 求 来 获取 服务 端 数据 四 


诬 取 服务 缮 数据 并 坚 元 系统 
PS 


图 13-13 ”从 服务 器 端 远程 获取 数据 

既然 能 够 远程 的 从 服务 器 端 获 取 数 据 ， 那 么 能 不 能 采用 本 地 数据 呢 ? 当然 能 了 ， 可 以 采用 

JavaScript 函数 获取 本 地 数据 , 在 正 浏览 器 的 地 址 栏 中 输入 “http://localhost:8080/Struts2_ 
13/result.jsp ”获取 本 地 数据 ， 执 行 效果 如 图 13-14 所 示 。 


本 地 JavaScript 范 数 处 理 动态 Div - Windows Internet Explorer 


OO Br re 


全 收藏 天 | 国 本 地 Twvaserint 函 注 外 理 动 Tiv 篇 - 国 呈 怖 ”页 面 P)， 安 8)。I 具 只)- 优 - ” 


A 


my 本 地 JAVAScRIPT 函 数 处 理 动态 Div 


直接 全 用 二 页 面 的 JavaScript 未 ， 不 再 话 用 远 得 服 乞 器 


13-14 ”获取 本 地 数据 
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13.4.5 ”实例 分 析 


a 


本 实例 首先 创建 了 一 个 RandomAction, 生成 一 个 随机 数 ， 当 访问 ajax_tab.jsp 页 面 成 功 时 ， 
在 该 页 面 中 通过 <s:url> 标 签 指定 value 属性 访问 random.action，id 属性 为 “rd”。 在 <s:div> 标 
签 中 通过 指定 href 属性 为 Hd， 来 动态 向 服务 器 端 获取 数据 ， 显 示 在 页 面 上 ， 通 过 指定 
showErrorTransportText="true"， 显 示 系 统 出 错 提示 。 

在 resultjsp 页 面 中 ， 通 过 div 标签 的 handler 属性 ， 指 定 本 页 面 的 脚本 函数 作为 处 理 函 数 
handler。 指 定 了 此 属性 ， 则 不 会 向 服务 器 发 送 Ajax 请 求 ， 指 定 的 href 属性 将 失效 ，handler 函 
数 使 用 本 地 数据 ， 显 示 在 div 元 素 中 。 


13.5 ”常见 问题 解答 


13.5.1 Ajax 获取 Struts 2 的 Action 的 返回 信息 问题 


Ajax 如 何 获取 Struts 2 的 Action 的 返回 信息 ? 
网 络 课堂 : http:Wbbs.itzcn.comy/thread-11016-1-1.html 


我 想 使 用 Ajax 获取 Struts 2 的 Action 返回 的 信息 ， 简 单 的 写 了 如 下 一 个 check0 方 法 ,不 
知 是 不 是 这 样 写 的 。 


public String check () throws Exception { 
// 获 取 HttpServletRedquest 对 象 request 
HttpServletRequest request=ServletActionContext.getRequest(); 
// 获 取 HttpServletResponse 对 象 response 
HttpServletResponse response=ServletActionContext.getResponse(); 
response.setContentType ("text/html;charset=UTF-8"); 
// 获 取 PrintWriter 对 象 out， 
PrintWriter out=response.getWriter(); 
System.out.println (user.getUserName ()); 
User u=userService.getUserByName (user.getUserName ()); 
if (u==nul1) 


// 输 出 jsp 页 面 
out.println ("<html><body> 恭 喜 您 用 户 名 可 用 ! </body></html>"); 
return null; 
} 
else 
上 
out .println ("<html><body> 对 不 起 ， 用 户 名 已 存在 ! </body></html>"); 
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return null; 
} 


但 是 ， 输 入 用 户 名 为 中 文 时 无 法 接收 参数 。 求 助 高 手 。 

【解决 办 法 】: 你 的 方法 里 不 用 写成 String， 写 成 void 不 返回 任何 东西 ， 在 out.println 
("<html><body> 恭 喜 您 用 户 名 可 用 ! </body></html>");， 前 台 的 Ajax 部 分 直接 接受 返回 过 来 的 
msg 信息 即 可 。 


13.5.2 Struts 2 中 使 用 Ajax 标签 出 错 问题 


Struts 2 中 使 用 Ajax 标签 出 错 ? 
网 络 课堂 : http://bbs.itzen.conmythread-11019-1-1.html 


今天 刚 学 Stmts 2 使 用 Ajax 标签 就 遇 到 问题 了 ， 正 如 标题 写 的 ， 我 在 JSP 页 面 的 
<head></head> 之 间 插 入 <s:head theme="ajax"/> 这 句 话 , 打开 页 面 弹 出 一 个 对 话 框 提示 站 点 无 法 
访问 , 如 果 把 <s:head theme="ajax"/> 这 名 取消 了 , 才能 打开 页 面 , 但 这 页 面 也 失去 Ajax 功能 了 。 
环境 的 配置 都 没 问 题 ， 请 教 高 手 解释 一 下 原因 出 错 原因 。 我 把 页 面部 分 关键 代码 粘贴 出 来 ， 代 
码 如 下 所 示 。 

<html> 

<head> 
<base href="<%=basePath%>"> 
<title>My JSP '‘'index.jsp' starting page</title> 


<meta http-equiv="pragma" content="no-cache"> 
<meta http-equiv="cache-control" content="no-cache"> 


<meta http-equiv="expires" content="0"> 
<meta http-equiv="keywords" content="keywordl,Kkeyword2,Kkeyword3"> 
<meta http-equiv="description" content="This is my page"> 
<s:head theme="ajax"/> <!-- 加 了 这 句 就 打 不 开 页 面 --> 
</head> 
<body> 
<s:form action="register" theme="ajax" validate="true"> 
<s:textfield label=" 用 户 名 " name="username"></s:textfield> 
<s:password label=" 密 码 " name="password"></s:password> 
<s:password label=" 重 新 输入 密码 " name="repassword"></s:password> 
<s:textfield label=" 年 龄 " name="age"></s:textfield> 
<s:textfield label=" 生 日 " name="birthday"></s:textfield> 
<s:submit value=" 发 布 "></s:submit> 
</s:form> 
<s:property value="result"/> 
</body> 
</html> 


【解决 办 法 】: 如 果 你 的 Struts 版 本 是 2.1.6 以 上 的 , 那 就 要 加 struts2-dojo-plugin-2.1.6.jar， 
Struts 2 升级 以 后 把 Ajax 单独 提出 来 放 这 个 里 面 了 。 


< 
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我 用 的 是 struts 2.1.8， 加 了 struts2-dojo-plugin-2.1.8jar 后 ， 页 面 改 成 如 下 所 示 。 


<%@ taglib prefix="s" uri="/struts-tags"%®> 


<%@ taglib prefix="sd" uri="/struts-dojo-tags"%®> 
<s:head /> 


<sd:parseContent="true"/> 


Struts 2 怎样 获取 Ajax post 请 求 传递 的 数据 ? 


Struts 2 怎样 获取 Ajax post 请 求 传递 的 数据 ? 
网 络 课堂 : http://bbs.itzen.comythread-11021-1-1.html 


我 需要 从 页 面 传递 一 个 对 象 数 组 ， 不 知道 Struts 2 怎样 获取 这 个 数组 ? 而 且 这 个 数组 对 象 
需要 转换 成 一 个 List 对 象 ， 提 示 Ognl 无 法 转换 的 错误 。 请 高 手 赐教 。 
【解决 办 法 】: 从 页 面 传 对 象 到 Action，Action 用 List 接收 ， 这 样 肯定 是 可 以 的 ， 只 要 你 
的 参数 名 字 相 同 就 行 。 如 果真 的 不 行 ， 那 就 是 用 Struts 2 的 类 型 转换 功能 ， 手 动 把 JS 数组 串 转 
换 为 Java 的 List， 需 要 用 Strutstypeconverter 接口 ， 从 Action 传 对 象 到 页 面 ， 把 JSON 串 以 流 
的 形式 写 入 页 面 ， 这 样 Ajax 就 会 接 到 。 如 果 你 不 熟悉 ， 那 么 可 以 使 用 JSON 插件 ， 目 的 是 简 
化 你 的 页 面 流 操作 , 到 页 面 的 JSON 只 是 字符 串 , 通过 JS 的 exal0 方 法 动态 编译 就 能 得 到 JSON 


13.6 习 题 

一 、 填 空 题 
(1) 使 用 DWR 框架 需要 配置 的 核心 Servlet 是 
(2) JSON 有 两 种 构建 结构 : “名 称 / 值 ”对 的 集合 和 5 
(3) JSON 的 数据 格式 有 : 对 象 、 数 组 、 值 、 和 数值 。 
(4) Dojo 的 常用 函数 dojo.connect 主要 用 于 
二 、 选 择 题 
(1) Ajax 术语 是 由 公司 或 组 织 最 先 提 出 的 。( 单 选 ) 

A. Google B. IBM C. Adaptive Path D. Dojo Foundation 
(2) 以 下 Web 应 用 不 属于 Ajax 应 用 。( 单 选 ) 

A. Hotmail B. Gmaps C. Flickr D. Windows Live 
(3) 以 下 技术 不 是 Ajax 技术 体系 的 组 成 部 分 。( 单 选 ) 

A. XMLHttpRequest B. DHIML C. CSS D. DOM 
(4) 下 列 方法 或 属性 是 Web 标准 中 规定 的 。( 单 选 ) 

A. all0 B. innerHTML 

C. getElementsByTagName() D. innerText 


(5) 下 列 
A. 


CG 
DD 


MS Visual InterDev 
MS Script Debugger 


每 一 个 函数 都 有 一 个 prototype 对 象 。 
函数 就 是 一 个 特殊 类 型 的 对 象 。 


第 13 章 当 Struts 2 碰见 Ajax 


工具 不 能 用 来 调试 浏览 器 中 的 JavaScript。( 单 选 ) 
B. Eclipse 
D. Mozilla Venkman 
(6) 关于 JavaScript 中 的 函数 和 对 和 象 ， 下 列 说 法 不 正确 的 是 
A. 
Be 


。( 单 选 ) 


元 数 附 属于 它 所 附加 到 的 对 象 上 ， 只 能 通过 该 对 象 访问 。 


同一 个 函数 可 以 被 附属 到 多 个 对 象 上 。 


(7) 创建 一 个 对 象 obj， 该 对 象 包含 一 个 名 为 “name” 的 属性 ， 其 值 为 “value”。 以 下 哪 


一 段 JavaScript 代码 无 法 得 到 上 述 的 结果 ? 
A. 


对 = 


CG: 
DD 


} 


Var obj = new Object (); 
obj["name"] = "value"; 
Var obj = new Object(); 
obj .prototype .name = "value"; 
Var obj = {name : "value"}; 
Var obj = new function() { 
this.name = "value"; 


三 、 上 机 练习 


上 机 练习 : 省 市 级 联 。 

要 求 : 首先 需要 创建 Province 和 City 两 个 实体 类 ， 然 后 创建 CityDao 操作 数据 库 类 ,定义 
查询 省 方法 findAllProvince()， 通 过 省 编号 查询 省 方法 findProvinceById(int proIld)， 通 过 省 编号 
查询 该 省 的 所 有 城市 方法 findCitysByProld(int prold)， 通 过 城市 编号 查询 城市 方法 
findCityById(int cityId)。 接 下 来 再 创建 一 个 Action 类 ShowCity.java， 在 该 类 中 创建 四 个 执行 方 
法 ， 分 别 是 findAllProvinceO 获 取 所 有 省 数据 、findProvinceByIdO 通 过 省 编号 获取 省 数据 、 
findCitysByProId(O) 通 过 省 编号 获取 该 省 的 所 有 城市 数据 和 findCityById0O 通 过 城市 编号 获取 城 
市 数据 。 最 后 创建 一 个 JSP 页 面 showCity.jsp， 在 该 页 面 中 定义 两 个 select 标签 分 别 用 于 选择 


省 和 城市 。 


执行 效果 如 图 13-15 所 示 。 


( 单 选 ) 


图 13-15 省 市 级 联 


< 
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内 容 摘 要 : 

为 了 宣传 一 个 太极 研修 院 的 实力 ， 宣 扬 研修 院 的 品牌 、 展 示 太 极 产品 ， 以 供 对 太极 感 兴趣 
的 成 员 可 以 放心 的 选择 本 研修 院 进行 学 习 ，XX 太极 研修 院 决定 通过 网 络 向 广大 群众 展示 出 研 
修 院 的 实力 和 魄力 。 本 网 站 采用 Strut 2+Hibernate 3 两 大 框架 实现 了 产品 展示 ， 并 通过 联系 研 
修 院 的 教员 购买 产品 、 查 阅 研修 院 的 最 新 动态 、 向 教员 咨询 问题 、 在 线 观 看 视频 等 功能 。 开 发 
工具 选择 了 MyEclipse7.0、MySql5.0 和 JDK1.6。 

学 习 目 标 : 

@ 掌握 Struts 2+Hiberante3 开发 模式 。 
掌握 Stmts2、Hibernate 配置 文件 中 的 配置 项 。 
熟练 使 用 Ant 技术 生成 Hibernate 映射 文件 。 
掌握 FCKEditor 与 JSP 整合 的 使 用 。 
熟练 的 配置 Struts 2 中 的 配置 文件 。 
掌握 分 页 技术 。 
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14.1 太极 研修 院 企业 网 站 简介 


太极 研修 院 是 一 个 培训 太极 拳法 的 学 院 ， 因 此 它 有 自己 学 院 的 风采 。 它 会 在 每 年 的 不 同时 
间 招 生 ， 以 供 那 些 爱好 习 武 的 人 学 习 太 极 拳法 。 在 这 个 科技 发 展 的 时 代 ， 怎 样 把 招生 消息 传播 
给 天 下 所 有 爱好 习 武 的 人 呢 ? 当然 是 网 络 ， 因 此 太极 研修 院 企 业 网 站 由 此 成 立 …… 


14.1.1 系统 功能 


本 章 所 介绍 的 网 站 是 一 个 功能 有 点 复杂 的 太极 研修 院 企 业 网 站 ， 本 网 站 以 展示 为 目的 ， 向 
读者 展示 一 种 良好 的 程序 架构 。 
1. 前 台 功 能 


本 网 站 前 台 主 要 分 为 首页 展示 、 企 业 简介 、 新 闻 中 心 、 太 极 商 城 、 在 线 视频 、 太 极 风采 、 
培训 招生 、 太 极 感 悟 、 个 人 博客 、 友 情 链接 和 联系 我 们 11 个 栏目 , 前 台 功 能 模块 图 解 如 图 14-1 
所 示 。 
下 面 是 各 栏目 功能 模块 的 详解 。 
1) 首页 展示 
首页 是 一 个 网 站 的 第 一 窗口 ， 是 浏览 者 对 企业 文化 第 一 印象 认 知 度 的 关键 页 面 。 页 面 的 布 
局 和 页 面 风格 的 设 定 ， 对 网 站 整体 定位 起 着 决定 性 的 作用 。 在 本 栏目 中 简单 的 介绍 太极 研修 院 
的 概况 及 背景 ， 以 供 浏 览 者 对 这 个 培训 中 心 有 个 初步 的 认识 。 这 里 使 用 一 个 静态 页 面 来 展示 。 
2) ”企业 简介 
向 浏览 者 介绍 太极 研修 院 , 管理 员 可 以 在 后 台 管理 系统 中 对 其 进行 添加 、 修改 、 删 除 操作 。 
企业 简介 的 内 容 可 以 是 图 片 、Flash、 视 频 、 文 字 等 , 这 里 使 用 FCKeditor 框架 与 JSP 整合 实现 。 
, 3) ”新 闻 中 心 
: 新 闻 中 心 存在 二 级 栏目 ， 即 : 太极 动态 、 理 论 天 地 、 太 极 养 生 、 武 林 资 讯 和 疑惑 解答 ， 对 
于 前 4 个 栏目 下 的 新 闻 ， 浏览 者 可 以 查看 新 闻 详情 及 对 该 条 新 闻 的 所 有 评论 ， 还 可 以 对 该 条 新 
闻 进 行 评论 ， 对 于 疑惑 解答 栏目 下 的 新 闻 ( 即 浏览 者 提问 的 问题 )， 浏 览 者 可 以 对 其 进行 回答 ， 
对 于 别人 的 回答 ， 浏 览 者 还 可 以 查看 别人 对 该 回答 内 容 进 行 的 评论 ， 也 可 以 对 其 进行 评论 。 在 
显示 新 闻 和 显示 评论 时 ， 都 使 用 分 页 显示 功能 。 
4) “太极 商城 
太极 商城 也 存在 二 级 栏目 ， 即 : 音像 制品 、 太 极 服装 、 太 极 器 械 和 太极 书籍 。 浏 览 者 可 以 
查看 商城 中 的 所 有 商品 的 详情 , 还 可 以 购买 (这 里 没有 实现 真正 意义 上 的 购买 , 只 是 单 击 “SHOP 
NOW” 按 钮 时 ， 跳 转 至 联系 我 们 页 面 )。 


>> 
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太极 动态 


| 评论 信息 
查看 信息 


首页 展 理论 天 地 


>| 评论 信息 
| 查看 信息 


太极 养生 


评论 信息 


查看 信息 


武林 资讯 


疑惑 解答 
音像 制品 
太极 服装 


太极 商城 


-| 评论 信息 
?| 阅读 问题 


[| 评论 回答 


太极 器 械 


太极 书籍 


在 线 观 看 


评论 视频 


查看 详情 


一 一 一 >| ”太极 风采 
太极 感 司 


图 14-1 前 台 功能 模块 图 解 


评论 风采 


< 人 mm 
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5) ”在 线 视频 

浏览 者 可 以 查看 所 有 有 关 太 极 研修 院 的 视频 内 容 ， 并 对 其 进行 评论 。 显 示 视 频 和 显示 评论 
都 使 用 分 页 显示 功能 。 

6) 太极 风采 


太极 风采 栏目 向 浏览 者 展示 本 研修 院 学 徒 的 一 些 风 采 ( 比 如 在 什么 活动 中 获得 了 哪些 奖 
项 )， 并 以 图 片 的 列表 形式 在 页 面 中 分 页 显示 ， 当 单 击 某 张 图 片 时 ， 显 示 该 条 信息 的 详细 信息 ， 
浏览 者 可 以 对 其 进行 评论 。 

7) 培训 招生 

这 个 栏目 和 企业 简介 模块 功能 的 实现 相同 ， 只 是 向 浏览 者 显示 数据 ,管理 员 可 以 在 后 台 对 
数据 进行 修改 、 删 除 、 添 加 操作 。 

8) ”太极 感悟 

太极 感悟 是 管理 员 与 学 徒 之 间 沟 通 的 桥梁 ,管理 员 可 以 在 后 台 发 表 学 太极 的 一 些 心得 , 浏 
览 者 可 以 对 其 进行 回复 。 当 浏览 者 访问 某 条 感悟 信息 一 次 ， 访 问 量 多 一 (在 Web 开发 中 ， 很 多 
时 候 要 用 到 此 功能 ， 不 可 忽视 )。 

9) 个 人 博客 

这 只 是 一 个 超 链接 ， 链 接 至 教员 的 博客 。 

10) 友情 链接 

对 于 一 个 成 功 的 企业 网 站 来 说 ， 这 个 栏目 必 不 可 少 。 通 过 本 网 站 可 以 链接 到 其 他 网 页 (或 
网 站 )。 

11) 联系 我 们 

在 太极 商城 栏目 中 已 经 提 到 过 此 栏目 ， 以 供 浏览 者 联系 我 们 。 


. 2. 后 台 功 能 


本 网 站 后 台 主 要 分 为 : 新 闻 中 心 、 太 极 商城 、 信 息 管理 、 用 户 管理 、 日 志 管 理 和 系统 信息 
6 个 栏目 ， 下 面 是 各 功能 模块 详解 。 


1) ”新 闻 中 心 
这 个 模块 供 管理 员 发 表 新 闻 、 修 改 新 闻 、 进 行 置顶 操作 、 删 除 新 闻 ， 功 能 模块 如 图 14-2 
所 示 。 


第 14 章 太极 研修 院 企业 网 站 


新 闻 中 心 


Y 了 当 了 
太 太 起 
极 极 林 
动 关 页 
态 生 讯 


本 
巧 束 则 赋 
当 峭 网 污 
总 峭 网 让 


图 14-2 新 闻 中 心 功能 模块 图 
2) ”太极 商城 
这 个 模块 供 管理 员 添 加 商品 、 修 改 商 品 信 息 、 删 除 商品 信息 ， 功 能 模块 如 图 14-3 所 示 。 


太极 商城 


区 看 vy 
音 太 太 
像 极 极 
制 服 日 
品 装 第 
Y 里 y vy 了 vy vy 
洪 修 册 添 修 诬 修 修 
加 改 除 加 故 加 改 改 
信 信 信 信 信 信 信 信 
息 息 息 息 息 息 息 息 


图 14-3 ”太极 商城 功能 模块 图 


< 人 mm 
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3) ”信息 管理 

此 模块 是 本 系统 的 核心 模块 ， 前 台中 的 大 部 分 栏目 功能 的 实现 都 包含 在 此 功能 模块 中 ， 其 
中 包含 企业 简介 、 在 线 视 频 、 联 系 我 们 、 培 训 招 生 、 友 情 链接 、 太 极 感悟 、 太 极 风采 、 评 论 信 
息 和 首页 幻灯 片 的 管理 模块 ， 管 理 员 可 以 对 这 些 信息 进行 添加 、 删 除 、 修 改 操作 ， 功 能 模块 如 
图 14-4 所 示 。 


企业 简介 添加 、 修 改 、 删 除 信息 
培训 招生 添加 、 修 改 、 删 除 信息 
理 
图 14-4 ”信息 管理 功能 模块 图 
4) 用户 管理 


在 此 模块 中 ， 管 理 员 可 以 查看 所 有 的 用 户 信息 ， 包 括 管理 员 信息 和 会 员 信息 ， 并 对 其 进行 
添加 、 修 改 、 删 除 等 操作 ; 管理 员 登 录 后 台 管 理 系 统 后 可 以 修改 自己 的 一 些 基本 信息 ; 管理 员 
还 可 以 对 角色 进行 管理 。 用 户 管理 栏目 功能 模块 如 图 14-5 所 示 。 
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随 束 澡 本 这 


修 | | 到 
改 | | 除 
信 月 后 
. 息 | | 有 


图 14-5 用 户 管理 功能 模块 图 


5) 日 志 管 理 

这 个 模块 供 管理 员 查 看 所 有 对 本 网 站 后 台 管 理 系统 操作 的 信息 ， 并 对 其 进行 一 键 删除 。 
6) ”系统 信息 

此 模块 只 是 显示 本 系统 的 一 些 相关 信息 。 


14.1.2 ”系统 架构 


本 系统 严格 采用 Java EE 的 三 层 机 构 ， 分 为 表现 层 、 业 务 罗 和 辑 层 和 数据 服务 层 。 三 层 体 系 
将 业务 规则 、 数 据 访 问 等 工作 放 到 中 间 层 处 理 ， 客 户 端 不 直接 与 数据 库 交 互 ， 而 是 通过 控制 器 
与 中 间 层 建立 连接 ， 再 有 中 间 层 与 数据 库 交 互 。 

表现 层 禁止 JSP 内 翌 Java 脚本 ， 因 而 比较 简单 ，JSP 页 面 使 用 Struts 2 标签 来 实现 数据 ， 
生成 页 面 显示 效果 。 中 间 层 采用 Stmts 2+Hibernate。 

如 果 需 要 将 Struts 2 与 Hibernate 整合 ， 必 然 有 如 图 14-6 所 示 的 架构 方案 。 

可 能 有 读者 对 图 14-6 感到 好 奇 : 为 什么 还 有 JDBC 技术 呢 ? 使 用 Hibernate 框架 不 是 可 以 
代替 JDBC 技术 吗 ? Hibernate 框架 可 以 代替 JDBC 技术 ， 一 旦 使 用 了 Hibemate 框架 ， 无 需 在 
程序 中 使 用 JDBC 技术 ， 但 是 Hibernate 的 数据 库 访 问 是 建立 在 JDBC 技术 基础 之 上 的 。 这 就 
是 说 ,虽然 使 用 Hibernate 无 需 显 式 的 使 用 JDBC 编程 ,但 Hibernate 框 架 本 身 还 必须 借助 于 JDBC 
技术 。 

本 项 目的 中 间 层 组 件 可 分 为 两 个 层 。 

@ 业务 轴 辑 层 : 该 层 的 组 件 专注 于 业务 逻辑 的 实现 ， 避 免 与 任何 的 持久 化 技术 耦合 。 

@ ”DAO 层 : 该 层 里 包含 大 量 的 DAO 组 件 ， 每 个 DAO 组 件 专注 于 底层 持久 化 实现 ， 

个 具体 的 DAO 组 件 只 能 与 特定 的 持久 化 技术 耦合 。 


< 人 mm 


thuts 2 Web 开 作 学 习 实录 省 


中 间 层 组 件 


通信 


Hibemate 技 术 


JDBC 技 术 


14-6 Struts 2 和 Hiberante 整 合 架构 


14.2 ”数据 库 设 计 和 实现 


-个 合理 而 适用 的 数据 库 表 设 计 对 于 一 个 成 功 的 Web 开发 来 说 占 着 主干 的 位 置 ， 这 一 节 
将 为 读者 讲解 一 下 太极 研修 院 企 业 网 站 的 数据 库 设 计 和 实现 。 
太极 研修 院 企业 网 站 采用 MySql5.5 数据 库 。 首 先 创建 一 个 数据 库 : dwtj， 接着 为 读者 具体 
分 析 一 下 数据 库 表 结 构 。 
1. 用 户 信息 表 (User) 
用 户 信 息 表 结 构 如 表 14-1 所 示 。 
表 14-1 用 户 信息 表 结构 


字段 名 称 含义 类 型 束 
id 用 户 Id int 
username 用 户 名 varchar(255) 
password 密码 varchar(255) 
realname 真实 姓名 varchar(255) 
phone 联系 电话 varchar(255) 
address 联系 地 址 varchar(255) 
e-mail 邮箱 地 址 
roleld 角色 Id， 引 用 角色 表 (Role) 中 的 id 字段 


2. 角色 信息 表 (Role) 
角色 信息 表 结 构 如 表 14-2 所 示 。 
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表 14-2 角色 信息 表 结 构 


字段 名 称 类 型 约 束 
id int 主键 
name varchar(255) 非 空 
tempString varchar(255) 可 以 空 


3. 新 闻 中 心 、 企 业 简 介 、 在 线 视 频 、 联 系 我 们 、 培 训 招 生 信息 表 (Messages) 


因为 这 5 个 栏目 的 内 容 格式 大 同 小 异 ， 因 此 新 闻 中 心 、 企 业 简介 、 在 线 视频 、 联 系 我 们 、 
培训 招生 5 大 栏目 的 信息 内 容 用 一 个 数据 表 来 实现 ， 表 结构 如 表 14-3 所 示 。 


表 14-3 ”新闻 中 心 、 企 业 简介 、 在 线 视频 、 联 系 我 们 、 培 训 招生 信息 表 结 构 


字段 名 称 含义 类 型 约束 
id 信息 14 int 主键 
name 信息 标题 varchar(255) | 非 空 
subject 信息 内 容 链 接 路 径 varchar(255) | 非 空 
createTime | 创建 时 间 date 非 空 
langType 语言 类 型 ， 分 为 中 、 英 文 两 种 类 型 varchar(255) | 非 空 
信息 类 型 ， 这 个 表 中 包含 有 新 闻 中 心 、 企 业 简介 、 在 线 视频 、 | . 
msyType | 联系 我 们 、 培 训 招生 等 栏目 的 信息 ， 这 个 字段 标识 特定 的 栏目 |" e 
tempStr 信息 来 源 varchar(255) | 可 以 空 
createUser 创建 人 varchar(255) | 非 空 
headMse 文章 导读 varchar(255) | 非 空 
clickNum 点 击 率 int 非 空 
parentId 上 级 栏目 Id， 引 用 信息 表 (Messages) 中 的 id 字段 int 非 空 
Sign 是 否 置 项 ，1 表示 置顶 ，0 表示 默认 int 非 空 


4. 商品 信息 表 (Products) 
商品 信息 表 结 构 如 表 14-4 所 示 。 
表 14-4 ”商品 信息 表 结构 


字段 名 称 含义 束 
id 商品 Id 
name 商品 名 称 varchar(255) 
intro 商品 简介 text 
price 商品 价格 double 
number 商品 编号 varchar(255) 
pic 商品 图 片 路 径 varchar(255) 
langType 语言 类 型 varchar(255) 
tempString 备用 字段 
msgType 商品 信息 类 型 ， 二 级 栏目 标识 


< 轩 一 — 
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5. 问题 信息 表 (Questions) 


新 闻 中 心 的 二 级 栏目 中 存在 一 个 疑惑 解答 栏目 ， 它 与 其 他 4 个 栏目 的 信息 结构 不 同 ， 这 里 
把 它 抽 取出 来 使 用 一 张 表 来 实现 ， 问 题 信息 表 结 构 如 表 14-5 所 示 。 


表 14-5 问题 信息 表 结 构 


字段 名 称 
id | 问题 主键 
question | 问题 内 容 varchar(255) 
createTime 


提问 时 间 date 
提问 者 ， 引 用 用 户 表 (Usen) 中 的 id 字 段 | i 
备用 字段 
6. 回答 问题 信息 表 (Answers) 


上 面 是 问题 表 的 结构 设计 ， 这 里 所 要 讲 的 就 是 针对 上 面 问题 的 回答 内 容 的 信息 表 设 计 ， 表 
结构 如 表 14-6 所 示 。 


UserId 


非 空 
可 以 空 


tempString varchar(255. 


表 14-6 ”回答 问题 信息 表 结构 


i 


i 
i 
varchar(255 


7. 太极 风采 信息 表 (Student) 
太极 风采 信息 表 结 构 如 表 14-7 所 示 。 
表 14-7 太极 风采 信息 表 结构 


字段 名 称 含义 类 型 约束 
id 信息 14 int 主键 
name 信息 名 称 varchar(255) 非 空 
createTime 创建 时 间 非 空 


imageUrl 图 片 链接 地 址 非 空 
Content 信息 内 容 text 非 空 
title Varchar(255) 非 空 
tempString 备用 字段 Varchar(255 可 以 空 
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8. 太极 感悟 信息 表 (PrenticeMsg) 
太极 感悟 信息 表 结构 如 表 14-8 所 示 。 


表 14-8 太极 感悟 信息 表 结 构 


字段 名 称 束 
id 
name varchar(255 
createTime 创建 时 间 date 
content 信息 内 容 varchar(255) 
title 信息 标题 varchar(255) 
checkedId 点 击 率 int 
tempString 备用 字段 varchar(255) 
langType 语言 类 型 varchar(255 
9. 友情 链接 信息 表 (FriendLink) 
友情 链接 信息 表 结构 如 表 14-9 所 示 。 
表 14-9 ”友情 链接 信息 表 结 构 
字段 名 称 一 一 一 一 一 一 一 一 一 | 束 
id 键 
tite 非 
addressUrl 非 
imgun 提 
tempStrin varchar(255) 


10. 评论 信息 表 (ReplyMsg) 


新 闻 、 太 极 感悟 、 疑 惑 解答 中 的 回答 内 容 都 存在 评论 功能 ， 因 此 评论 信息 表 必 不 可 少 ， 表 
结构 如 表 14-10 所 示 。 
表 14-10 评论 信息 表 结 构 

字段 名 称 含义 类 型 
id 信息 Td int 
content 评论 内 容 varchar(255) 
createUser | 评论 人 姓名 varchar(255) 
createTime | 评论 时 间 date 

主 贴 It， 引 用 信息 表 (Messages)、 太 极 感悟 表 (PrenticeMsg)、 回 | _ 
topicId 全 int 

答 问题 表 (Answers) 表 中 的 id 字段 
topicType 主 贴 类 型 。1 表示 新 闻 ，2 表示 太极 感悟 ，3 表示 回答 问题 int 
arented 对 评论 进行 评论 ， 引 用 评论 信息 表 (ReplyMsg) 表 中 的 id 字段 int 

tempStrin 备用 字段 Varchar(255 
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11. 系统 日 志 表 (SystemLogs) 
系统 日 志 信息 表 结 构 如 表 14-11 所 示 。 
表 14-11 系统 日 志 信息 表 结 构 


字段 名 称 含义 类 型 约 束 

id 日 志 信息 1d int 主 

Username 操作 者 varchar(255) 非 堂 
loginTime 操作 时 间 date 非 空 

loginIP 操作 者 的 了 P 地址 varchar(255) 非 空 
operationName | 操作 内 容 varchar(255) 非 空 

userId 操作 者 I4， 引 用 用 户 表 (UseD 中 的 这 字段 “| int 非 空 

tempStr 备用 字段 Varchar(255 可 以 空 


14.3 后台 模 块 一 一 新 闻 中 心 


由 于 此 项 目 功能 的 实现 太 多 ， 我 不 再 一 一 介绍 ， 读 者 可 以 根据 本 章 源码 来 做 具体 的 分 析 ， 
这 里 只 讲解 典型 的 模块 功能 的 实现 。 

此 项 目 在 web.xml 文件 中 ， 配 置 的 Struts 2 控制 器 (org.apache.struts2.dispatcher.Filter 
Dispatcher) 的 拦截 路 径 为 “.action”。 


14.3.1 ”查询 新 闻 信息 ， 分 页 显示 


前 面 已 经 提 到 新 闻 中 心 栏目 中 包括 太极 动态 、 理 论 天 地 、 太 极 养生 、 武 林 资 讯 和 疑惑 解答 
5 个 栏目 ,而 前 4 个 栏目 信息 存储 在 同一 张 表 中 (Messages 表 ), 在 Messages 表 中 有 一 个 msgType 
字段 ， 定 义 太 极 动态 的 msgType 值 为 7、 理 论 天 地 的 msgType 值 为 8、 太 极 养生 的 msgType 
值 为 9、 武 林 资 讯 的 msyType 值 为 10。 下 面 来 具体 的 讲解 一 下 实现 步骤 。 

(1) 在 项 目 中 新 建 com.dwtj.model 包 ， 在 该 包 下 新 建 Messages 类 。 由 实体 类 生成 映射 文 
件 ， 采 用 Ant 技术 ， 在 实体 类 中 的 属性 上 配置 如 下 代码 格式 。Messages 类 的 内 容 如 下 。 


public class Messages { 
/妇女 
* @hibernate.id 
* generator-class="native™ 
人 
Private int id;// 信 息 Id， 主 键 
/太太 
* @hibernate.property 
*/ 
private String name;// 消息 名 称 
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/*# 

* @hibernate.property 

区 
Private String subject;// 映射 路 径 
/** 

* @hibernate.property 

大 
Private Date createTime;// 创建 时 间 
/*# 

* @hibernate.property 

党 类 
Private String langType;// 语言 类 型 
/*# 

* @hibernate.property 

i 
private int msgType;// 消息 类 别 
/#*# 

* @hibernate.property 

A 
private String createUser;// 创 建 人 
/妇女 

* @hibernate.property 

vl 
private String headMsg;// 文 章 导读 
/妇女 

* @hibernate.property 

i 
private String tempStr;// 信息 来 源 
妇女 

* @hibernate.property 

中 
private int clickNum;// 点 击 量 
/*# 

* 上 级 菜单 

* @hibernate.property 

Ww 
private int parentId; 

/妇女 

* 是 否 置顶 

* @hibernate.property 

法 


private int sign; 
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/* 下 面 是 上 面 所 有 属性 的 set、get 方法 ， 这 里 省 略 */ 


} 
(2) 新 闻 栏 目 中 的 所 有 信息 都 要 用 到 分 页 显示 ， 


因此 必须 要 为 分 页 做 好 准备 。 新 建 


com.dwtj.common 包 ， 在 该 包 下 新 建 PageBean 类 ， 内 容 如 下 。 


< 人 mm 
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5 


public class PageBean { 
private String hql = ""; // 查询 的 语句 
private int nowpage = 0; // 当前 页 
private Integer totalpage = 0; // 总 页 数 
private int pagesize = 20; // 每 页 显示 最 大 值 
private int totalCount =0; // 当 前 查询 的 总 条 数 
Q@SuppressWarnings ("unchecked") 
private List result = new ArrayList (0); 
/* 下 面 是 上 面 所 有 属性 的 set 、get 方法 ， 这 里 省 略 */ 


(3) 在 com.dwtj.common 包 下 新 建 分 页 处 理 类 PageCtr， 内 容 如 下 。 


public class PageCtr { 


public static PageBean PageCtrUpdate (PageBean pageBean ,String markv int 


number){ 
// 如 果 mark 为 “f”， 则 跳 转 至 首页 
if (mark.equals("f")) { 
pageBean.setNowpage (0); 


} 
// 如 果 mark 为 “1”， 则 跳 转 至 尾 页 
else if (mark.equals("1")) 1{ 
pageBean.setNowpage (pageBean.getTotalpage() - 1); 


// 如 果 mark 为 “p”， 则 跳 转 至 上 一 页 


else if (mark.equals("p") && pageBean.getNowpage() != 0) 


pageBean.setNowpage (pageBean.getNowpage() - 1); 


; 
// 如 果 mark 为 “n”， 则 跳 转 至 下 一 页 


else if (mark.equals ("n") 


&& pageBean.getNowpage() != pageBean.getTotalpage() - 1) 


bageBean .setNowpage (PageBean .getNowpage () + 1) 7 


， 

// 如 果 mark 为 “t”， 则 跳 转 至 指定 页 码 

else if(mark.equals (" 七 ") ) { 
pageBean .setNowpage (number-1) 


return pageBean; 


{ 


(4) 创建 DAO 层 架 构 。 在 项 目 中 新 建 com.dwtj.dao 包 , 该 包 下 存放 了 持久 层 的 所 有 接口 ， 
在 该 包 下 新 建 MessagesDao 接口 ， 负 责 与 持久 化 对 象 交 互 ， 封 装 了 数据 的 增 、 删 、 改 、 查 等 操 


作 ， 内 容 如 下 。 
public interface MessagesDao { 
// 添 加 信息 
public boolean addMessage (Messages msg); 


// 修 改 信息 


public boolean updateMessage (Messages msg); 
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// 删 除 信息 

public boolean deleteMessage (int msgId) ; 

// 分 页 查询 信息 

public PageBean selectMessagesNewsAll]l (PageBean pageBean, String sql) 


(5) 创建 DAO 层 实 现 类 。 在 项 目 中 新 建 com.dwtj.dao.impl 包 , 在 该 包 下 新 建 MessagesDao 
接口 的 实现 类 MessageDaoImpl， 实 现 MessagesDao 接口 中 的 方法 ， 内 容 如 下 。 


public class MessageDaoImpl implements MessagesDao 1{ 
// 添 加 信息 
public boolean addMessage (Messages msg) { 

// 定 义 返回 结果 

boolean con=false; 

// 定 义 Session 对 象 

Session session=null; 

// 定 义 Transaction 对 象 

Transaction tx=null; 

try{ 
// 获 取 Session 对 象 ， 调 用 HibernateSsessionFactory 类 中 的 getsession() 

方法 

session=HibernateSessionFactory.getSession(); 
// 获 取 Transaction 对 象 ， 调 用 session 中 的 beginTransaction () 方 法 
tx=session.beginTransaction(); 
// 调 用 session 中 的 sava (entity entity) 方 法 保存 数据 
session.save (msg); 
con=true; 
// 提 交 事务 
tx.commit (); 

}catch (Exception ex){ 
ex.printstackTrace (); 
tx.rollback(); 

}finally{ 
session.close(); 

3 


return con; 


上 
// 删 除 信息 
public boolean deleteMessage (int msgId) { 
boolean con=false; 
Session session=nul17 
Transaction tx=null; 
tryt{ 
// 获 取 session 对 象 
session=HibernateSessionFactory.getSession(); 
// 获 取 Transaction 对 象 
tx=session.beginTransaction(); 
// 获 取 特 定 的 信息 
Messages msg=(Messages)session.get (Messages.class, msgId); 
// 这 里 使 用 FCKeditor 与 JSP 整合 ， 因 此 需要 把 FCKeditor 内 容 页 面 从 存放 路 径 中 
删除 掉 


< 
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String pathDb = 
ServletActionContext .getServletContext () .getRealPath( 
msg.getSsubject ()); 

ReadInFile.judgefilename (pathDb); 
// 删 除数 据 
session.delete (msg) ;// 删 除 信息 
con=true; 
tx.commit (); 

}catch (Exception ex){ 
ex.printstackTrace (); 
te rolibacklys 

}finally{ 
session.close(); 

. 


return con; 


» 
// 修 改 信息 
public boolean UpdateMessage (Messages msg) 1{ 
Session session=null; 
Transaction tx=null; 
boolean con=false; 
try{ 
// 获 取 session 对 象 
session=HibernateSessionFactory.getSession(); 
// 获 取 Transaction 对 象 
tx=session.beginTransaction(); 
// 把 修改 后 的 值 重 新 覆盖 修改 前 的 值 
Messages messages=(Messages)session.get (Messages.class, 
msg.getId()); 
messages.setCreateTime (msg.getCreateTime ()); 
messages.setCreateUser (msg.getCreateUser ()); 
messages.setHeadMsg (msg.getHeadMsg ()); 
messages.setMsgType (msg.getMsgType ()); 
messages.setName (msg.getName ()); 
messages.setSubject (msg.getSubject ()); 
messages.setclickNum (msg.getClickNum()); 
messages.setTempSstr (msg.getTempStr () ) 7 
messages .setSign (msg.getsign()); 
// 修 改 数据 
session.update (messages) 7 
con=true; 
tx.commit (); 
}catch (Exception ex){ 
ex.printstackTrace (); 
tx.rollback(); 
}finallyt{ 
session.close(); 


return con; 


ls 
// 根 据 不 同 的 sql 语句 查询 不 同 的 信息 
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public PageBean selectMessagesNewsRA11 (PageBean pageBean String sql) { 
// 获 取 session 对 象 
Session session = HibernateSessionFactory.getSession(); 
// 根 据 不 同 的 条 件 语句 查询 所 有 的 信息 ， 并 分 页 显示 
List<Messages> list = session-createQuery( 
"from Messages "+sql+" order by sign desc,id desc "). 
setMaxResults( 
pageBean.getPagesize()) .setFirstResult( 
pageBean.getNowpage() * pageBean.getPagesize()) .list(); 
pageBean.setResult (list); 
// 获 取 符 合 条 件 的 数据 条 数 
Object obj = session.createQuery( 
"select count(*) from Messages "+sql 
) .uniqueResult (); 
int count = Integer.parseInt (obj.tostring()); 
// 给 PageBean 类 中 的 totalcount 属性 赋值 
pageBean.setTotalCount (count); 
// 获 取 总 页 数 
count = (count + pageBean.getPagesize() - 1) / pageBean.getPagesize(); 
pageBean.setTotalpage (count); 
return pageBean; 


(6) 创建 业务 层 接 口 。 在 项 目 中 新 建 com.dwtj.service 包 ， 在 该 包 下 新 建 MessagesService 
接口 ， 编 写 需 要 实现 的 方法 ， 代 码 如 下 。 


public interface MessagesService { 


} 


// 添 加 信息 

public boolean addMessage (Messages msg) 7 
// 修 改 信息 

public boolean updateMessage (Messages msg); 
// 删 除 信息 

public boolean deleteMessage (int msgId) 
// 根 据 不 同 的 sql 语句 查询 不 同 的 信息 


public PageBean selectMessagesNewsAll (PageBean pageBean, String sql) ; 


(7) 编写 业务 层 实现 类 MessageServiceImpl， 实 现 上 面 接 口中 的 4 个 方法 ， 代 码 如 下 。 


public class MessageServiceImpl implements MessagesService { 


MessagesDao msgDao=new MessageDaoImpl (); 

// 添 加 信息 页 面 

public boolean addMessage (Messages msg) { 
return msgDao.addMessage (msg); 


} 

// 删 除 信息 

public boolean deleteMessage(int msgId) { 
return msgDao.deleteMessage (msgId); 


} 
// 修 改 信息 


< 
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public boolean updateMessage (Messages msg) 1{ 
return msgDao.updateMessage (msg) 7 

} 

// 根 据 不 同 的 条 件 查询 所 有 信息 

public PageBean selectMessagesNewsAll (PageBean pageBean, String sql) { 
return msgDao.selectMessagesNewsAll]l (pageBean, sql); 


} 
(8) 当 单 击 后 台 管 理 系 统 左边 菜 单 导航 中 新 闻 中 心 栏目 下 的 二 级 栏目 时 , 需要 根据 不 同 的 


msgType 值 来 查询 不 同 的 新 闻 信息 数据 。 在 com.dwtj.actions 包 下 新 建 MessageAction 类 ,继承 


自 com.opensymphony.xwork2.ActionSupport 类 ， 编 写 分 页 显示 信息 数据 方法 ， 代 码 如 下 。 
// 引 用 Messages 实体 类 


Private Messages msg7 


/+* 省 略 Messages 对 象 属性 msg 的 set、get 方法 */ 


// 查 询 新 闻 中 心 二 级 菜单 中 的 内 容 
public String findNews(){ 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest (); 
// 从 session 对 象 中 获取 PageBean 对 象 
PageBean pageBean = (PageBean) request.getSession() .getAttributel( 
"pageBean"); 
if (pageBean == null) { 
pageBean = new PageBean(); 
1 
string mark = ""; 
// 如 果 从 页 面 中 传 过 来 的 mark 值 不 为 nul11， 获 取 mark 值 ， 否 则 跳 转 至 首页 
if (request.getParameter("mark") != null) { 
mark = request.getParameter ("mark"); 
} else { 
mark = "f"; 


// 定 义 要 跳 转 的 页 码 
int tempNumber = 0; 
if (redquest .getParameter ("number") != null) 1{ 
tempNumber = Integer 
.parseInt (request .getParameter ("number") .trim()); 


// 调用 业务 层 分 页 显示 数据 
pageBean = msgService.selectMessagesNewsAll (PageCtr.PageCtrUpdatel( 
pageBean, mark, tempNumber), " where 

msgType="+msg.getMsgType ()); 

request.setAttribute("msgs", pageBean.getResult ()); 

request.setAttribute("msgType", msg.getMsgType ()); 

pageBean.setResult (null); 

request .getSession() .setAttribute ("pageBean", pageBean); 

return "secondMsg"; 
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(9) 在 项 目的 根 目 录 下 新 建 Ant 的 辅助 文件 build.xml， 使 用 它 可 以 将 实体 类 Messages 自 
动 生成 Messages.hbm.xml 映射 文件 和 hibernate.cfg.xml 配置 文件 。 内 容 如 下 。 


<?xml version="1.0" encoding="GBK"?> 


<project name=" 太 极 研修 院 构建 脚本 " default=" 生 成 Hibernate 配置 文件 " basedir="."> 


<property name="src.dir" value="${basedir}/src"/> 
<property name="build.dir" value="${basedir}/bin"/> 
<property name="xdoclet.home" value="E:\soft\xdoclet-plugins-1.0.3"/> 
«l=— Build classpath —=> 
<path id="xdoclet.task.classpath"> 
<fileset dir="${xdoclet.home}/lib"> 
<include name="**/*.jar"/> 
</fileset> 
<fileset dir="${xdoclet.home}/plugins"> 
<include name="**/*.jar"/> 
</fileset> 
</path> 
<taskdef 
name="xdoclet" 
classname="org.xdoclet .ant .XDocletTask" 
classpathref="xdoclet .task.classpath" 
/> 
<target name=" 生 成 Hibernate 配置 文件 "> 
<xdoclet> 
<fileset dir="${src.dir}/com/dwtj/model"> 
<include name="**/*.java"/> 
</fileset> 
<component 


classname="org.xdoclet .plugin.hibernate.HibernateConfigPlugin" 
destdir="${src.dir}" 
version="3.0" 
hbm2ddlauto="update" 
jdbcurl="jdbc:mysql://localhost:3306/dwtj" 
jdbcdriver="com.mysql.jdbc.Driver" 

"root™ 


dialect="org.hibernate.dialect.MySQLDialect™" 
showsql="true" 
> 
</xdoclet> 
</target> 
<target name=" 生 成 hibernate 映射 文件 "> 
<xdoclet> 
<fileset dir="${src.dir}/com/dwtj/model"> 
<include name="**/*.java"/> 
</fileset> 
<component 


classname="org.xdoclet .plugin.hibernate.HibernateMappingPlugin™ 
version="3.0" 


怀 全 mm 
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destdir="${src.dir}" 
We 
</xdoclet> 
</target> 
</project> 


(10) 选择 MyEclipse 中 的 Window | Show View | Other... | Ant | Ant 选项 ,打开 Ant 窗口 。 
单 击 窗口 工具 栏 中 的 党 图 标 ， 添 加 上 面 编写 好 的 build.xml 文件 ， 出 现 如 图 14-7 所 示 的 结构 ， 
右 击 “生成 hibernate 映射 文件 ”， 选 择 Run As | Ant Build， 生 成 Messages 映射 文件 。 生 成 
Hibernate 配置 文件 和 生成 Hiberante 映射 文件 步骤 一 样 。 


Eni cords Wome 


FEZY EE 


OM oy fed 


[mrs 
| 


14-7 ”Ant 结构 
(11) 在 sre 下 新 建 struts.xml 文件 ， 配 置 异常 处 理 。struts.xml 文件 内 容 如 下 。 


<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<constant name: 


"struts.il8n.encoding" value="gbk" /> 
<constant name="struts.devMode" value="true" /> 
<package name="ma" namespace="/" extends="struts-default"> 
<!-- 自 定义 拦截 器 用 于 检测 是 否 登录 --> 
<global-results> 
<result name="error">/common/exception.jsp</result> 
</global-results> 
<global-exception-mappings> 
<exception-mapping result="error™" 
exception="java.lang.RuntimeException"> 
</exception-mapping> 
</global-exception-mappings> 
</package> 
</struts> 


(12) 新 建 struts-config 文件 ， 新 建 message.xml 文件 ， 配 置 MessageAction 类 ， 配 置 如 下 。 


<package name="message" namespace="/message" extends="ma"> 
<action name="message" class="com.dwtj.actions.MessageAction"> 
<result name="secondMsg">/admin/news/index.jsp</result> 
</action> 


</package> 
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(13) 在 admin 文件 夹 下 的 leftjsp 页 面 中 添加 导航 菜单 ， 内 容 如 下 。 


<TR> 


<TD width="2%"><IMG src="admin/Images/closed.gif"></TD> 

<TD height=23><A 
href="message/message!findNews.action?msg.msgType=7" target=main> 太 极 动态 
</R></TD> 
</TR> 
<TR> 

<TD><IMG src="admin/Images/closed.gif"></TD> 

<TD height=23><A 
href="message/message!findNews.action?msg.msgType=8" target=main> 理 论 天 地 
</A></TD> 
</TR> 
<TR> 

<TD><IMG src="admin/Images/closed.gif"></TD> 

<TD height=23><A 
href="message/message!findNews.action?msg.msgType=9" 
target=main> 太 极 养生 </A> </TD> 
</TR> 
<TR> 

<TD><IMG src="admin/Images/closed.gif"></TD> 

<TD height=23><A 
href="message/message!findNews.action?msg.msgType=10" 
target=main> 武 林 资 讯 </A> </TD> 
</TR> 


(14) 在 admin 下 新 建 news 文件 夹 , 在 news 文件 夹 下 新 建 index.jsp 页 面 , 分 页 显示 查询 出 
来 的 数据 ， 代 码 如 下 。 


<%@ page language="java" import="java.util.*" pageEncoding="gbk"%> 
<%@ taglib prefix="s" uri="/struts-tags" %> 
<table class="table" cellspacing="1" cellpadding=" 
align="center" border="0"> 
<tbody> 
I 和 
<th height="25" colspan="5" align="left" class="man"> 
<s:if test="#request .msgType==7"> 太 极 动态 </s:if> 
<s:elseif test="#request .msgType==8"> 理 论 天 地 </s:elseif> 
<s:elseif test="#request.msgType==9"> 太 极 养生 </s:elseif> 


width="100%" 


<s:elseif test="#request.msgType==10"> 武 林 资 讯 </s:elseif> 
</th> 
<th height="25" align="right"” class="addMsg" colspan="4"> 添 加 新 闻 
&nbsp; 发 布 最 新 新 闻 
</th> 
</tr> 
Es 


<td class="td bg" width="15%" height="25"> 
<div align="center"> 信 息 标题 </div> 

</td> 

<td class="td bg" width="10%"> 


已 mm 
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<div align="center"> 创 建 时 间 </div> 
</td> 
<td width="10%" class="td bg"> 
<div align="center"> 创 建 人 </div> 
</td> 
<td width="15%" class="td bg"> 
<div align="center"> 文 章 导读 </div> 
</td> 
<td width="5%" class="td bg"> 
<div align="center"> 语 言 </div> 
</td> 
<td width="10%" class="td bg"> 
<div align="center"> 评 论 </div> 
</td> 
<td class="td bg" width="6%"> 
<div align="center"> 和 置顶 </div> 
</td> 
<td class="td bg" width="6%"> 
<div align="center"> 编 辑 </div> 
</td> 
<td class="td bg" width="6%"> 
<div align="center"> 删 除 </div> 
</td> 
</tr> 
<s:if test="#request.msgs.size()!=0"> 


<s:iterator value="#request .msgs" var="msg"> 


二 二 


<td class="td bg" height="25"” style="color: 


<s:if test="#msg.sign: 


着 9933337z> 


<font style="font-size:12px;color:red;"> 顶 </font> 


</s:if> 


<s:if test="#msg.name .trim() .length()>30"> 
<s:property value="%{#msg.name.substring(0,30)}"/> 


</s:if> 
«seLe> 


<s:property value="#msg.name"/> 


</s:else> 
</td> 
<td class="td bg"> 


<s:date name="#msg.createTime" format="yyyy-MM-dd"/> 


</td> 
<td class="td bg"> 


<s:property value="#msg.createUser"/> 


</td> 
<td class="td bg"> 


<s:if test="#msg.headMsg.trim() .length()>20"> 
<s:property value="%{#msg.headMsg.substring(0,20)}" /> 


2 
<s:else> 


<s:property value="#msg.headMsg"/> 


</s:else> 


si) >> 
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</td> 
<td class="td bg"> 
<s:if test="#msg.langType.equals (\"zh\")"> 中 文 </s:if> 
<s:else> 英 文 </s:else> 
</td> 
<td class="td bg" width="10%">【 查 看 评论 】</td> 
<td class="td bg" width="10%"> 
<s:if test="#msg.sign==0">【 和 置顶 】</s:if> 
<s:else>【 取 消 置顶 】</s:else> 
</td> 
<td class="td bg"” width="10%">【 编 辑 】</td> 
<td class="td bg"” width="10%">【 删 除 】</tad> 
< 
</s:iterator> 
全 二 
区 二 
<tr> 
<td colspan="9" align="center" class="td bg" height="25px"> 暂 无 数 
据 </td> 
</tr> 
</s:else> 
<s:if test 
<tr> 
<th class="bg tr" align="right" colspan="9" height="25"> 
<s:push value="#request.session.pageBean"> 
共 <span class="red"><s:property value="totalCount" 
/></span> 条 记录 当前 第 <span class="red"><s:property 
value="nowpage+1" /></span>/<s:property value="totalpage" /> 页 每 页 <s:property 
value="pagesize" /> 条 数据 
</s:push> 
<s:a 


"#request.msgs.size() 1!=0"> 


href="message/message!findNews.action?msg.msgType=%{#request .msgType} &mark= 
fgnumber=0"> 首 页 </s:a> 

RS 
href="message/message!findNews.action?msg.msgType=%{#request .msgType}&mark= 
p&number=0"> 上 一 页 </s:a> 

<s:a 
href="message/message!findNews.action?msg.msgType=%{#request .msgType} &mark= 
ngnumber=0"> 下 一 页 </s:a> 


<s:a 
href="message/message!findNews.action?msg.msgType=%{#request .msgType} &mark= 
l&number=0"> 尾 页 </s:a> 
</th> 
</tr> 

/a 

</tbody> 
</table> 


到 此 ,分 页 显示 新 闻 信息 已 经 完成 ， 单 击 网 站 后 台 管 理 系统 左边 导航 菜单 中 的 太极 动态 模 


块 ， 出 现 如 图 14-8 所 示 的 页 面 。 


< 


14-8 ”太极 动态 信息 列表 


当前 显示 的 是 第 一 页 数据 ， 每 页 显示 20 条 ， 单 击 界面 中 的 “下 一 页 ”按钮 ， 页 面 跳 转 至 
第 二 页 ， 但 是 数据 少 于 20 条 ， 单 击 “ 下 一 页 ”按钮 时 ， 页 面 不 会 跳 转 。 太 极 动态 、 理 论 天 地 、 
太极 养生 和 武林 资讯 4 个 模块 呈现 出 来 的 页 面 与 上 图 14-8 大 同 小 异 ， 只 是 数据 不 一 样 而 已 。 


14.3.2 ”添加 新 闻 信 息 


管理 员 可 以 在 后 台 管理 系统 中 添加 新 闻 信息 。 
(1) 在 MessageAction 类 中 添加 方法 ， 实 现 新 闻 信息 的 添加 功能 ， 代 码 如 下 。 


// 添 加 新 闻 

public String addInputNews (){ 
HttpServletRequest request=ServletActionContext .getRequest (); 
// 把 Messages 类 中 msgType 属性 值 存放 在 HttpservletRequest 对 象 中 


request.setAttribute("msgtype", msg.getMsgType()); 


return "addNewsInput"; 


} 
(2) 在 struts-config 文件 夹 下 的 message.xml 文件 中 配置 “addNewsInput” 的 结果 页 面 ， 配 
置 代码 如 下 。 


<result name="addNewsInput">/admin/news/addInput.jsp</result> 


(3) 在 页 面 中 添加 JavaScript 代码 ， 在 新 窗口 中 打开 添加 新 闻 界 面 ， 代 码 如 下 。 


function openWin(f, n, w, h, s) { 

eh oh Det ee ed 

1 = (screen.width - w) / 2; 

t = (screen.height - h) / 2; 

sFeatures = "left=" + 1 + ",top=" + t + ",height=" + h + ",width=" + w+ 
",center=]1, scrollbars=" + sb + ",status=0,directories=0,channelmode=0"; 

openwin = window.open(f, n, sFeatures); 

IE (!openwin.opener) { 

openwin.opener = self; 


| 
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openwin.focus(); 
return openwin; 


] 
(4) 给 页 面 中 的 “添加 新 闻 ” 按 钮 中 添加 事件 ， 代 码 如 下 。 


<a 
onclick="openWin('message/message!addIinputNews.action?msg.msgType=<s:proper 
ty value="#request .msgType"/>', 'addInput',900,700,1);"> 添 加 新 闻 </a> 


(5) 当 单 击 界面 中 的 “添加 新 闻 ” 按 钮 时 ， 在 新 窗口 中 打开 添加 新 闻 界 面 ， 输 入 新 闻 的 
些 信 息 ， 单 击 添加 新 闻 界 面 中 的 “保存 信息 ”提交 按钮 ， 提 交 表 单 至 MessageAction 类 中 的 
addMessage() 方 法 (表单 action="message/messageladdMessages.action")， 执 行 添加 新 闻 操 作 。 
MessageAction 类 中 的 addMessage0 方 法 代码 如 下 。 


// 添 加 信息 
public String addMessages() { 
try { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest () 
// 获 取 登 录用 户 信息 ， 当 用 户 登录 时 ， 检 查 用 户 是 否 是 合法 用 户 ， 如 果 是 ， 存 储 至 
HttpServletRequest 对 象 中 
Users loginUser = (Users) 
request .getSession() .getAttribute ("login"); 
// 新 闻 内 容 采 用 了 FCKEdirtor 与 JSP 整合 ， 这 里 把 FCKeditor 中 的 内 容 生 成 了 一 
个 页 面 , uploadDir 为 页 面 存 储 路 径 
String path = 
ServletActionContext .getServletContext () .getRealPath( 
uploadDir); 
String pathDb = ServletActionContext.getServletContext () 


.getRealPath (RandomStringtable.genRandomNum ("upLoadDB/")); 
// 把 添加 的 内 容 生成 一 个 页 面 ， 并 存放 至 指定 的 路 径 下 
LoadImgforstring lifs = new LoadImgforString (msg.getSubject ()， 
path, true); 
ReadInFile.method2 (pathDb, lifs.getAimstring()); 
// 向 Messages 类 中 的 一 些 属性 赋值 
msg.setName (StringHtml .converthtml (msg.getName ())); 
msg.setHeadMsg (StringHtml .converthtml (msg.getHeadMsg ())); 
msg.setSubject (pathDb.substring (pathDb.length() - 35)); 
// 这 里 有 很 多 栏目 的 信息 采用 了 这 个 方法 执行 添加 操作 , 因此 需要 设置 Messages 类 中 
的 个 别 属性 值 。 
// 如 果 不 是 新 闻 中 心 信息 ， 无 一 级 菜单 
if(msg.getMsgType ()<7){ 
msg.setParentId(0); 
}else { 
msg.setParentId(1); 


} 

// 获 取 发 表 新 闻 的 作者 姓名 

String createUserstring=""; 

if(loginUser.getRealname ()==""||loginUser.getRealname ()==null){ 


< 
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createUserstring=" 佚 名 "; 
}elsef{ 
createUserSstring=loginUser.getRealname (); 
} 
msg.setCreateUser (CreateUserString) 7 
// 是 否 置顶 ， 默 认 不 置顶 
msg-setSign (0) 
// 创 建 时 间 为 当前 时 间 
msg.setCreateTime (new Date()); 
// 调 用 业务 层 方 法 ， 执 行 添加 操作 
msgService.addMessage (msg) 7 
} catch (Exception ex) { 
ex.printSstackTrace () 7 
让 
return "addMsg"; 
} 


测试 程序 ， 单 击 新 闻 中 心 管理 首页 界面 上 的 “添加 新 闻 ” 按 钮 ， 打 开 如 图 14-9 所 示 的 界 
面 。 输 入 信息 ， 单 击 “ 保 存 信息 ”按钮 ， 添 加 新 闻 成 功 。 


14-9 ”添加 新 闻 界面 


14.3.3 ”修改 新 闻 信息 


修改 和 删除 功能 的 实现 非常 简单 ， 下 面 以 修改 为 例 ， 讲 解 一 下 其 实现 思路 。 

(1) 在 新 闻 中 心 管理 首页 中 的 “编辑 ”按钮 中 添加 超 链接 : message/messagelupdateInput. 
action?msg.id=<s:property value="#nsg.id"/> 。 读 者 需要 把 新 闻 Id 传 过 去 作为 标识 ， 在 
MessageAction 类 中 编辑 updateInput0 方 法 ， 代 码 如 下 。 

// 打 开 修改 信息 界面 

public String updateInput () { 
SessionFilterAction.getUser (); 
// 获 取 HttpServletRequest 对 象 


5 
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HttpServletRequest request = ServletActionContext.getRequest () 7 

// 根 据 新 闻 Id 获取 特定 的 新 闻 数据 

Messages msgs = msgService.getMessageById (msg.getId());// 获取 特定 的 信息 

// 读 取 新 闻 内 容 信息 

String pathDb = ServletActionContext .getServletContext () .getRealPath( 
msgs .getSubject ()); 

msgs -setSubject (ReadOutFile.readFile (pathDb)); 

// 把 要 修改 的 信息 保存 至 HttpservletRequest 对 象 中 

request.setAttribute("msg", msgs); 

return "updateMsg"; 


} 


(2) 在 struts-config 文件 夹 下 的 message.xml 文件 中 配置 “updateMsg” 的 结果 页 面 ， 配 置 
代码 如 下 。 


<result name="updateMsg">/admin/message/updateInput.jsp</result> 


(3) 编辑 updateInputjsp 页 面 ， 加 载 特定 的 新 闻 信息 ， 代 码 如 下 。 


<form action="message/message!updateMessage.action" method="post" 
enctype="multipart/form-data" name="myform"> 
<table width="90%" border="0" align="center" cellpadding="5" 
cellspacing="1" class="table"> 
<input type="hidden" name="msg.id" value="<s:property 
value="#request .msg.id"/>" > 
<input type="hidden" narme: 
value="#request .msg.langType"/>"/> 
<input type="hidden" name="msg.msgType" value="<s:property 


msg.langType" value="<s:property 


value="#request .msg.msgType"/>"/> 
<input type="hidden" name="msg.clickNum" value="<s:property 
value="#request .msg.clickNum"/>"/> 
<input type="hidden" name="msg.tempSstr" value="<s:property 
value="#request .msg.tempstr"/>"/> 
<input type="hidden" name="msg.sign" value="<s:property 
value="#request .msg.sign"/>"/> 
<tr> 
<th colspan="2" height="30px" class="STYLES5" align="left"> 更 新 信 
息 </th> 
</tr> 
<tr> 
<td height="25" align="center" class="td bg"> 
<strong><font color="#FF0000"> 火 </font> 信 息 标 题 </strong> 
</td> 
<td width="86%" class="td bg"> 
<input type="text" name="msg.name" size="40" id="titname" 
maxlength="30" value="<s:property value="#request.msg.name"/>" 
onblur="checktitle()"/> 
</td> 
</tr> 
<tr> 
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<td height="25" align="center" class="td bg"> 
<strong> 内 容 提 要 </strong> 
</td> 
<td height="25" align="left" class="td bg"> 
<textarea rows="2" cols="83" name="msg.headMsg" id="headmsg" 
onblur="checkhead ()"><s:property value="#request.msg.headMsg"/></textarea> 
</td> 
去 VE 工交 
<tr> 
<td height="25" align="center" class="td bg"> 
<strong><font color="#FF0000"> 火 </font> 内 容 <br> 
</strong> (字数 5000 字 左 右 最 佳 ) 
</td> 
<td class="td bg"> 


<s:property value="#request.msg.subject" 
escape="false"/> 
</td> 
EE 
天 七 工 之 
<th align="center" colspan="2"> 
<input type="submit" value=" 更 新 信息 ">&nbsp; gnbsp; 
<input type="button"” value=" 取 消 " 
javascript:window.close();"> 
</th> 
</tr> 
</table> 


</form> 


(4) 配置 以 后 ， 当 单 击 新 闻 中 心 首页 中 的 “编辑 ”按钮 时 ， 页 面 跳 转 至 “admin/ 
Imessage/updateInputjsp” 页 面 ， 在 这 个 页 面 中 以 表单 的 形式 输出 新 闻 信 息 ， 以 供 管 理 员 修 改 。 
修改 后 , 单 击 页 面 中 的 “更 新 信息 ?按钮 ,提交 修改 表单 至 MessageAction 类 中 的 updateMessage() 
方法 ， 该 方法 可 以 实现 修改 新 闻 信息 功能 ， 代 码 如 下 。 

// 更 新 消息 


public String updateMessage() { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext .getRequest (); 
try 
// 重 新 把 修改 后 的 新 闻 内 容 生 成 页 面 


String pathDb = ServletActionContext .getServletContext () 


.getRealPath (RandomStringtable.genRandomNum ("upLoadDB/")); 
ReadInFile.method2 (pathDb, msg.getSubject()); 
msg.setSubject (pathDb.substring (pathDb.length() - 35)); 
// 获 取 登 录用 户 信息 
Users users = (Users) request.getSession() .getRAttribute("1ogin") 7 
// 设 置 修改 时 间 
msg.setCreateTime (new Date()) 7 


// 设 置 修改 者 
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String sourcenameString=""; 
if(users.getRealname()==""||users.getRealname ()==null1){ 
sourcenamestring=" 佚 名 "; 
jelse { 
sourcenameString=users.getRealname (); 
} 
msg.setCreateUser (sourcenameString); 
// 设 置 新 闻名 称 
msg.setName (StringHtml .conVverthtml (msg.getName ())); 
// 设 置 新 闻 导读 
msg.setHeadMsg (StringHtml .converthtml (msg.getHeadMsg ())); 
if(msg.getMsgType ()<7){ 
msg.setParentId(0); 
}else { 
msg.setParentId(1); 


} 
// 调 用 业务 层 方法 ， 执 行 修改 操作 
msgService.updateMessage (msg); 
} catch (Exception e) { 
e.printstackTrace (); 
} 
return "updateSuccess"; 


测试 程序 。 单 击 新 闻 中 心 管理 首页 界面 上 的 “编辑 ”按钮 ， 查 询 特定 的 信息 ， 并 加 载 至 
message 文件 夹 下 的 updateInput.jsp 页 面 上 ， 运 行 效果 如 图 14-10 所 示 。 


14-10 ”新 闻 更 新 界面 


新 闻 的 删除 和 修改 大 同 小 异 ， 思 路 完全 一 样 ， 这 里 不 再 讲述 。 

新 闻 中 心 的 二 级 栏目 中 还 有 一 个 疑惑 解答 栏目 ， 它 的 新 闻 信 息 存放 在 独立 的 表 中 
(Questions 表 )， 功 能 的 实现 和 上 面 所 讲 到 的 思路 完全 一 样 ， 这 里 也 不 再 讲述 ， 读 者 可 以 查看 案 
例 源码 进行 进一步 的 了 解 。 


< 
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14.4 前 台 心 


新 闻 中 心 栏目 分 为 太极 动态 、 理 论 天 地 、 太 极 养 生 、 武 林 资 讯 和 疑惑 解答 5 个 栏目 ， 也 就 
是 说 这 5 个 栏目 需要 在 前 台 展 现 出 来 。 为 了 简单 ， 这 里 的 栏目 是 固定 的 ， 也 就 是 说 不 需要 从 数 
据 库 中 读 取 栏目 ， 只 要 在 页 面 上 显示 即 可 。 


14.4.1 获取 二 级 栏目 的 新 闻 信 息 


在 前 台 浏览 新 闻 中 心 下面 的 信息 时 , 需要 把 新 闻 中 心 的 三 级 栏目 下 的 所 有 新 闻 查 询 并 展示 
出 来 。 

(1) 在 MessageAction 类 中 编辑 getSecondMenu() 方 法 , 调用 业务 层 的 方法 分 别 查询 出 太 级 
动态 、 理 论 天 地 、 太 极 养生 、 武 林 资 讯 和 疑惑 解答 栏目 下 的 新 闻 信息 ， 方 法 的 实现 代码 如 下 。 


// 点 击 新 闻 中 心 ， 获 取 二 级 菜单 信息 
public String getSecondMenu(){ 
HttpServletRequest request=ServletActionContext .getRequest (); 
// 调 用 业务 层 方法 查询 太极 动态 栏目 
List<Messages> dongList=msgService.getMessage(5, msg.getLangType(), 
Tn 
request.setAttribute("dongs", dongList); 
// 调 用 业务 层 方法 查询 理论 天 地 
List<Messages> li=msgService.getMessage(5, msg.getLangType(), 8); 
request .setAttribute("li", 1i); 
// 调 用 业务 层 方法 查询 太极 养生 
List<Messages> yangList=msgService.getMessage(5, msg.getLangType(), 
9 
request.setAttribute("yanglist", yangList); 
// 调 用 业务 层 方法 查询 武林 资讯 
List<Messages> wuList=msgService.getMessage(5, msg.getLangType(), 
10); 
request.setAttribute("wulist", wuList); 
// 查 询 疑惑 解答 问题 
List<Questions> quList=questionService.getQuestionList(); 
request .setAttribute("questions", quList); 
request.getSession () .setAttribute ("lang",msg.getLangType () ) ;// 获 取 语 言 
return "menu"; 


} 

上 面 代码 调用 了 业务 层 MessageServiceImpl 类 中 的 getMessage(int num,String langType, int 
msgType) 方 法 ， 获 取 了 太 级 动态 、 理 论 天 地 、 太 极 养 生 和 武林 资讯 4 个 栏目 的 新 闻 信 息 。 
getMessage(int num,String langType,int msgType) 方 法 有 三 个 参数 ， 其 中 ， 第 一 个 参数 表示 要 显 
示 的 数据 条 数 ; 第 二 个 参数 表示 显示 的 信息 是 中 文 还 是 英文 ; 第 三 个 参数 表示 要 显示 的 新 闻 是 
哪个 栏目 的 。 这 样 把 三 个 参数 传递 给 业务 层 方法 后 ， 业 务 层 方法 会 根据 传 过 去 的 语言 类 型 (第 


mm >> 


第 14 章 “太极 研修 院 企业 网 站 


二 个 参数 )、 信 息 类 型 (第 三 个 参数 ) 查 询 出 符合 条 件 的 前 5 条 数据 ， 并 返回 一 个 List<Messages> 
集合 。 疑 惑 解答 的 信息 获取 无 需 参数 ， 只 是 查询 出 来 的 结果 数据 也 是 根据 语言 类 型 ， 并 且 也 是 
只 查询 了 前 5 条 数据 。 

(2) 在 struts-config 文件 夹 下 的 message.xml 文件 中 配置 “menu” 的 结果 页 面 ， 配 置 如 下 。 


<result name="menu">/news menu.jsp</result> 


(3) 在 根 目 录 下 新 建 news_menu.jsp 页 面 ， 把 查询 出 来 的 结果 数据 显示 出 来 。 这 里 只 把 太 
极 动态 栏目 下 的 新 闻 信息 显示 代码 贴 出 来 。 


<s:if test="#session.lang.equals(\"zh\")"> 
太极 动态 
EE 
<s:else> 
Tai Ji Dynamic 
</s:else> 
<ul class="ul"> 
<s:if test="#request.dongs.size()>0"> 
<s:iterator value="#request .dongs" var="dong"> 
<1li> 
<img src="images/new.gif" width="30" height="8"/> 
<a style="clear:both;cursor: pointer;" 
href="message/message!findNewById.action?msg.id=<s:property 
value="#dong.id"/>&msg.langType=<s:property 
value="#session.lang"/>&sign=news"> 
<s:if test="#dong.name .trim() .length()>8"> 
<s:property value="%{#dong.name.substring (0,8)}" />... 
</s:if> 
<s:else> 
<s:property value="#dong.name" /> 
</s:else> 
</a> 
</1i> 
</s:iterator> 
/Bs 
<s:else> 
<1i> 
<s:if test="#session.lang.equals (\"zh\")"> 暂 无 数据 </s:if> 
<s:else>Sorry! This category have nothing data.</s:else> 
/is 
</s:else> 
</ul> 


理论 天 地 、 太 极 养 生 、 武 林 资 讯 和 疑惑 解答 下 的 新 闻 展 示 代 码 和 上 面 代码 大 同 小 异 ， 具 体 
代码 的 实现 请 查看 本 案例 源码 。 

(4) 在 网 站 中 文 首页 导航 中 的 “新 闻 中 心 ”栏目 中 添加 超 链 接 : message/messagelgetSecond 
Menu.action?msg.langType=zh， 英 文 首 页 导航 中 添加 超 链接 : message/message!lgetSecondMenu. 


action2msg.langType=en。 


< 
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运行 程序 ， 新 闻 中 心 列表 页 面 如 图 14-11 所 示 。 


14-11 ”获取 二 级 栏目 的 新 闻 信息 界面 


14.4.2 ”获取 特定 的 新 闻 信 息 


读者 在 上 面 代码 中 看 到 ， 在 显示 新 闻 列 表 时 ， 对 新 闻 标 题 (名 称 ) 设 置 了 一 个 超 链接 : 
message/message!findNewByld.action?msg.1d=<s:property value="#dong.id"/>&msg.langType=< 
s:property value="#session.lang"/>&sign=news， 也 就 是 说 ， 当 浏览 者 单 击 新 闻 列 表 中 的 新 闻 标 题 
时 ， 系 统 访问 MessageAction 类 中 的 findNewById0 方 法 ， 并 把 新 闻 Id 作为 参数 传 过 去 。 

(1) 在 MessageAction 类 中 编辑 findNewById0 方 法 ， 代 码 如 下 。 


// 获 取 具 体 的 新 闻 信息 
public String findNewById() { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest (); 
Messages news = msgService.getMessageById (msg.getId()); 
// 获取 特定 的 新 闻 信息 
y) request .getSession () .setAttribute("lang", msg.getLangType()); 
// 获取 语言 
// 把 查询 到 的 特定 新 闻 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("news", news); 
request .getSession() .setAttribute ("sign", 
request .getParameter ("sign")); 
// 当 阅读 特定 新 闻 时 ， 点 击 率 加 1 
news .SetC1lickNum (msgService.getCountClick (msg.getId())+1); 
// 调 用 业务 层 方法 ， 更 新 点 击 率 
msgService.updateMessage (news); 
return "news"; 


(2) 在 struts-config 文件 夹 下 的 message.xml 文件 中 配置 “news” 的 结果 页 面 ， 配 置 代码 
如 下 。 
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<result name="news">/news show.jsp</result> 
(3) 在 系统 根 目录 下 新 建 news_show.jsp 页 面 ， 显 示 特 定 的 新 闻 人 信息， 代码 片段 如 下 。 


信息 来 源 : 
<s:if test="#request-news .tempStr-equals (\"ziN")"> 本 站 原创 </s:if> 
<s:else> 转 载 信息 </s:else> 
更 新 时 间 : <s:date name="#request.news.createTime" format="yyyy-MM-dd"/> 作者 : 
<s:property value="#request.news.createUser"/> 访问 量 : <s: property 
value="#request .news.clickNum"/> 
新 闻 内 容 : <jsp:include 


page='<%=( (Messages)request .getAttribute ("news")) .getSubject () $%>'/> 


单 击 新 闻 列 表 页 面 中 的 新 闻 列 表 中 的 新 闻 标 题 ， 页 面 跳 转 至 news ”show.jsp 页 面 ， 如 
图 14-12 所 示 。 


14-12 ”前 台 查阅 特定 的 新 闻 信 息 


14.5 “后台 模块 一 一 太极 商城 


太极 商城 栏目 下 又 存在 音像 制品 、 太 极 服装 、 太 极 器 械 和 太极 书籍 4 个 二 级 栏目 ， 在 商品 
数据 表 (Products) 中 存在 一 个 “msgType” 字 段 ， 此 字段 标识 商品 信息 栏目 : 1 表示 音像 制品 、2 
表示 太极 服装 、3 表示 太极 器 械 、4 表示 太极 书籍。 


14.5.1 查询 商品 信息 ， 分 页 显示 


(1) 在 com.dwtj.actions 包 下 新 建 ProductAction 类 ， 继 承 自 com.opensymphony.xwork2. 
ActionSupport 类 ， 并 重 写 父 类 的 execute0 方 法 ,在 该 方法 中 调用 商品 业务 层 类 中 的 方法 , 根据 
不 同 的 商品 栏目 查询 该 栏目 下 的 所 有 信息 ， 分 页 显示 。execute0 方 法 代码 如 下 。 

// 查 询 所 有 的 商品 信息 ， 分 页 显示 


public String execute() throws Exception { 
// 获 取 HttpservletRequest 对 象 


< 
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HttpServletRequest request = ServletActionContext.getRequest () 7 


PageBean pageBean (PageBean) request.getSession() .getAttributel( 


"pageBean") 7 
if (PageBean == null) { 
pageBean = new PageBean(); 
} 
String mark = ""; 


if (request.getParameter ("mark") != null) { 
mark = request.getParameter ("mark"); 
} else { 


mark = "f"; 
} 
int tempNumber = 0; 
if (request.getParameter ("number") != null) { 

tempNumber = Integer 

-parseInt (request .getParameter ("number") .trim()); 

} 
// 调用 业务 层 分 页 显示 数据 
EEy 

pageBean = 

productService.selectProductsAll (PageCtr.PageCtrUpdatel( 
pageBean, mark, tempNumber), 20, "",product .getMsgType ()); 

} catch (Exception e) { 

e.printstackTrace () 7 
// 把 页 面 中 传 过 来 的 商品 栏目 标示 储存 起 来 
request.setAttribute("msgType", product.getMsgType()); 
// 把 获取 到 的 符合 条 件 的 商品 信息 存放 在 HtLtpservletRequest 对 象 中 
request.setAttribute("products", pageBean.getResult ()); 
pageBean.setResult (null); 
request.getSession() .setAttribute ("pageBean", pageBean); 
return "productIndex"; 

} 
(2) 在 struts-config 文件 夹 下 新 建 product.xml 文件 ， 配 置 ProductAction 类 ， 并 配置 


“productIndex” 的 结果 页 面 ， 配 置 代码 如 下 。 


<package name="product" namespace="/product" extends: 
<action name="product" class="com.dwtj.actions.ProductAction" > 
<result name="productIindex">/admin/product/index.jsp</result> 
</action> 


"ma"> 


</package> 


(3) 在 后 台 管理 系统 中 的 左边 导航 菜单 中 ， 设 置 太极 商城 模块 的 二 级 栏目 超 链 接 ， 路 径 如 


下 所 示 。 
<a href="product/product.action?product.msgType=1l" target="main"> 音 像 制品 
</a> 
<a href="product/product.action?product.msgType=2" target="main"> 太 极 服装 
</a> 
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<a href="product/product.action?product .msgType=3" target="main"> 太 极 器 械 


</a> 


<a href="product/product.action?product .msgType=4" target="main"> 太 极 书 籍 


</a> 


(4) 在 admin 文件 夹 下 新 建 product 文件 夹 , 并 在 product 文件 夹 下 新 建 index.jsp 页 面 , 把 
商品 信息 展示 出 来 ， 代 码 如 下 。 


<table class="table" cellspacing="1" cellpadding="2" width="100%" 
align="center" border="0"> 


<tr> 
<th height="25" colspan="4" align="]left" class="man"> 
交 训 中 test="#request .msgType==1"> 音 像 制品 </s:if> 
4 人 7- test="#request .msgType==2"> 太 极 服装 </s:elseif> 
<s:elseif test="#request .msgType==3"> 太 极 器 械 </s:elseif> 
<s:else> 太 极 书籍 </s:else> 
</th> 
<th height="25" align="right" class="addMsg" colspan: "> 添加 商品 </th> 
/EFS 
Er 
<td "td bg" width="15%" height="25"> 商 品名 称 </td> 
<td "15%" class="td bg"> 商 品 价格 </td> 
<td class="td bg"” width="15%"> 商 品 编码 </td> 
<td class="td bg"” width="15%"> 语 言 </td> 
<td class="td bg"” width="15%"> 编 辑 </td> 
<td class="tqd bg" width="15%"> 删 除 </td> 
</tr> 


<s:if test="#request.products.size()!=0"> 
<s:iterator value="#request.products" var="product"> 


We 


xsiE> 


tr> 
<td class="td bg" width="15%" height="25"> 
<s:if test="#product.name.trim() .length()>20"> 
<s:property value="%{#product.name.substring(0,20)}" 


</s:if> 
<s:else> 
<s:property value="#product .name"/> 
</s:else> 
</td> 
<td class="td bg” width="15%"> 
<s:property value="#product .price"/> 
</td> 
<td class="td bg" width="15%"> 
<s:property value="#product.number"/> 
</td> 
<td class="td bg” width="15%"> 
<s:if test="#product.langType.equals(\"zh\") "> 中文 


<s:else> 英 文 </s:else> 


</td> 
<td class="td bg"” width="159%">【 编 辑 】</td> 


<@—— 


二 人 Web 开发 学 习 实录 


<td class="td bg"” width="15$">【 删 除 】</td> 


</tr> 
</s:iterator> 
</s:if> 
<svelse> 
EF 
<td colspan="6" class="td bg"” height="25px"> 暂 无 商品 信息 </td> 
</tr> 


</s:else> 
<s:if test="#request.products.size!=0"> 
<tr> 
<th class="bg tr" align="right" colspan="6" height="25"> 
<s:push value="#request.session.pageBean"> 
共 <span class="red"><s:property value="totalCount" 
/></span> 条 记录 &nbsp7 当前 第 <span class="red"><s:property Value="nowpage+1" 
/></span>/<s:property value="totalpage" /> 页 &nbsp; 每 页 <s:property 
value="pagesize" /> 条 数据 
</s:push> 
<s:a 
href="product/product .action?product .msgType=%{#request .msgType} gsmark=f&num 
ber=0"> 首 页 </s:a> 
<s:a 
href="product/product .action?product .msgType=%{#request .msgType} &mark=p&num 
ber=0"> 上 一 页 </s:a> 
<s:a 
href="product/product .action?product .msgType=%{#request .msgType} tsmark=n&num 
ber=0"> 下 一 页 </s:a> 
<s:a 
href="product/product .action?product .msgType=%{#request .msgType} tmark=l1&num 
ber=0"> 尾 页 </s:a> 
</th> 
</tr> 
< 
</table> 


单 击 左边 导航 太极 商城 模块 下 的 “音像 制品 ”， 出 现 如 图 14-13 的 页 面 效果 。 


14-13 ”太极 商城 管理 首页 
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14.5.2 ”添加 商品 信息 


从 上 图 14-13 中 可 以 看 到 ， 在 太极 商城 管理 首页 右上 角 有 一 个 “添加 商品 ”按钮 ， 这 个 按 
钮 和 新 闻 中 心 模块 中 的 新 闻 添加 的 实现 一 样 。 
(1) 在 太极 商城 管理 首页 中 的 “添加 商品 ”按钮 上 添加 “onclick” 事 件 ， 代 码 如 下 。 
<a 
onclick="openWin('product/product!addIinputProduct .action?product .msgType=<s 
:property value="#request .msgType"/>', 'addInput',800,900,1);"> 添 加 商品 </a> 
(2) 通过 上 面 的 连接 地 址 ， 单 击 “ 添 加 商品 ”按钮 时 ， 执 行 ProductAction 类 中 的 
addInputProduct( 方 法 ， 这 个 方法 的 功能 就 是 打开 添加 商品 页 面 ， 方 法 的 实现 代码 如 下 。 
// 打 开 添加 商品 信息 
public String addInputProduct () { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request=ServletActionContext .getRequest (); 
// 把 商品 栏目 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("msgType", product.getMsgType()); 


return "addInputProduct"7 


} 
(3) 在 struts-config 文件 夹 下 的 product.xml 文件 中 配置 打开 添加 商品 的 结果 页 面 ， 即 
“addInputProduct” 的 结果 页 面 ， 配 置 如 下 。 
<result name="addInputProduct">/admin/product/add input.jsp</result> 


(4) 单 击 太极 商城 管理 首页 右上 角 的 “添加 商品 ”按钮 ， 打 开 如 图 14-14 的 页 面 。 


14-14 ”添加 商品 信息 界面 
(5) 在 ProductAction 类 中 添加 addProduct0 方 法 ,实现 商品 信息 的 添加 功能 。 代 码 如 下 。 
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// 添 加 商品 信息 
public String addProduct() { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext .getRequest (); 
EE 汪 
// 获取 文件 路 径 ， 实 现 图 片 的 上 传 功能 
String path = 
ServletActionContext .getServletContext () .getRealPath ( 
savePath); 
File imageFile = new File(path + "\\" + fileFileName); 
if(imageFile.toString() .indexOf ("null")==-1){ 
System.out .println (imageFile); 
// 定 义 一 个 上 传 文件 的 输入 流 
BufferedInputStream bis = null; 
// 定 义 一 个 上 传 文件 的 输出 流 
BufferedOoutputSstream bos = null; 
try 1 
// 获取 一 个 上 传 文件 的 输入 流 
bis = new BufferedInputStream (new FileInputstream(file)); 
// 获取 一 个 上 传 文件 的 输出 流 
bos = new BufferedOutputStream (new 
FileOutputstream(imageFile)); 
byte buf[] = new byte[(int) file.length()]; 
int length 07 
while ((length = bis.read(buf)) != -1) { 
bos.write(buf, 0, length); 


} 
} catch (Exception e) { 
e.printstackTrace (); 
Einally: 并 
try { 
Ei 
bis.close(); 
} 
} catch (Exception e) { 
e.printstackTrace () 7 
} 
try { 
if (bos != null) { 
bos.close(); 
l: 
} catch (Exception e) { 
e.printstackTrace (); 


} 
// 获 取 图 片 路 径 ， 并 赋值 


product .setPic("proImages/" + imageFile.getName()); 
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// 把 Fckeditor 中 的 内 容 生 成 一 个 页 面 并 保存 至 特定 的 路 径 下 
String pathl= 
ServletActionContext .getServletContext () .getRealPath( 
uploadDir); 
String pathDb = ServletActionContext.getServletContext () 


.getRealPath (RandomStringtable.genRandomNum ("upLoadDB/")); 
LoadImgforString lifs = new LoadImgforString (product .getIntro(), 
pathl, true); 

ReadInFile.method2 (pathDb, lifs.getAimstring()); 
product.setIntro (pathDb.substring (pathDb.length() - 35)); 
// 调 用 业务 层 方法 ， 执 行 添 加 商品 信息 操作 
productSservice.addProduct (product); 

} catch (Exception e) { 
e.printstackTrace () 7 

} 

return "adqSuccess"7 


} 


到 此 ， 商 品 信息 的 添加 功能 就 完成 了 ， 单 击 添加 商品 信息 界面 上 的 “添加 ”按钮 时 ， 执 行 
ProductAction 类 中 的 addProduct0 方 法 ， 完 成 添加 功能 的 操作 。 


14.5.3 删除 商品 信息 


商品 信息 的 更 新 和 删除 思路 大 同 小 异 , 前 面 在 讲解 后 台 管理 系统 中 的 新 闻 中 心 模块 时 已 经 
提 到 过 ， 都 需要 把 特定 信息 的 Id 作为 参数 ， 传 递 给 Action 类 中 执行 信息 的 更 新 或 删除 的 实现 
方法 中 。 
(1) 在 ProductAction 类 中 编辑 delProduct0 方 法 ， 实 现 商 品 的 删除 操作 ， 方 法 的 实现 代码 
如 下 。 
// 删 除 商品 信息 
public String delProduct() { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest (); 
// 调 用 业务 层 方法 ， 实 现 商品 信息 的 删除 操作 
productService.deleteProduct (product .getId()); 
SystemLogsCommon .getSystemLogsMessage (equest， "删除 商品 信息 "); 


return "delSuccess"; 


} 

(2) 在 struts-config 文件 夹 下 的 productxml 文件 中 配置 “delSuccess” 的 结果 页 面 。 当 执 
行 删除 操作 后 可 以 跳 转 至 Action 类 中 的 查询 所 有 商品 信息 方法 , 即 execute() 方 法 , 读者 可 以 根 
据 需 要 设置 结果 页 面 。 

(3) 在 太极 商城 管理 首页 中 的 “删除 ”按钮 中 添加 链接 ， 代 码 如 下 所 示 。 


< 
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<a style="cursor: pointer;" 
onclick="del('product/product!delProduct .action?product.id=<s:property 
value="#product .id"/>')">“ 删 除 ”</a> 


单 击 “ 删 除 ” 按 钮 提示“ 你 确认 要 删除 记录 吗 ? ”信息 ， 如 图 14-15 所 示 。 


图 14-15 ”删除 商品 时 的 提示 信息 


14.6 前台 展示 一 一 太极 商城 


太极 商城 栏目 下 存在 音像 制品 、 太 极 服装 、 太 极 器 械 和 太极 书籍 4 个 二 级 栏目 ， 这 里 和 新 
闻 中 心 的 二 级 栏目 一 样 ， 也 是 固定 的 ， 只 需要 把 二 级 栏目 下 的 商品 信息 读 取 到 页 面 上 展示 出 来 
即 可 。 


14.6.1 获取 二 级 栏目 的 商品 信息 


当 单 击 前 台 首页 中 的 “太极 商城 ”栏目 时 ， 动 态 的 读 取 二 级 栏目 下 的 商品 信息 ， 并 以 列表 
的 形式 展示 在 页 面 中 。 

(1) 在 ProductAction 类 中 编辑 getMenu0 方 法 ， 调 用 业务 层 方法 getproList(String 
langType,int msgType) 获 取 商 品 信息 列表 ， 其 中 , “langType” 参 数 表 示 语 言 类 型 、“msgType” 
表示 栏目 标识 ， 即 在 业务 层 查询 商品 信息 集合 是 根据 语言 类 型 和 栏目 来 进行 的 ， 只 查询 出 符合 
条 件 的 前 7 条 数据 ， 并 在 页 面 上 显示 出 来 。getMenu() 方 法 的 实现 代码 如 下 。 

// 获 取 二 级 菜单 信息 
public String getMenu(){ 


HttpServletRequest request=ServletActionContext .getRequest () 7 
Tequest .getSession() .setAttribute("lang", product.getLangType ()); 
// 查 询 音 像 制品 栏目 下 的 商品 信息 
List<Products> 

yinsList=productService.getproList (product.getLangType(), 1); 
request.setAttribute("yins", yinsList); 
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// 查 询 太极 服装 栏目 下 的 商品 信息 

List<Products> 
fuList=productService.getproList (product .getLangType(), 2); 

request.setAttribute("fus", fuList); 

// 查 询 太 极 器 械 栏目 下 的 商品 信息 

List<Products> 
qiList=productService.getproList (product .getLangType(), 3); 

request.setAttribute("qis", qiList); 

// 查 询 太极 书籍 栏目 下 的 商品 信息 

List<Products> 
shuList=productService.getproList (product.getLangType (), 4); 

request.setAttribute("shus", shuList); 

return "menupro"; 


} 
(2) 在 struts-config 文件 夹 下 的 productxml 文件 中 配置 “menupro” 的 结果 页 面 , 配置 如 下 。 
<result name="menupro">/product menu.jsp</result> 


(3) 在 项 目的 根 目录 下 新 建 product_menu.jsp 页 面 ， 把 查询 到 的 信息 展现 在 页 面 上 。 代 码 
如 下 。 
<div id="hotNews" style="width: 230px; height: 200px; border-collapse: collapse; 
border-width: lpx; border-color: #C90; border-style: solid; float: left;"> 
<h3> 
<s:if test="#session.lang.equals (\"zh\") "> 音像 制品 </s:if> 
<s:else>AudiogVideoProducts</s:else> 
</h3> 
<ul class="ul"> 
<s:if test="#request.yins.size()>0"> 
<s:iterator value="#request.yins" var="yin"> 
<1i> 
<s:if test="#Yyin.name .trim() .Jength ()>15"> 
<s:property value="g%{#yin.name.substring(0,15)}]"”/>… 
</s:if> 
<s:else><s:property value="#yin.name" /></s:else> 
</1i> 
</s:iterator> 
e/a2aE> 
xBelse> 
I 
<s:if test="#session.lang.equals (\"zhN") "> 暂 无 数据 </s :if> 
<s:else>Sorry! This category have nothing data.</s:else> 
</1i> 
<Lselse> 
</ul> 
</div> 


上 面 是 显示 音像 制品 栏目 下 的 商品 信息 列表 代码 ， 显 示 太 极 服装 、 太 极 器 械 和 太极 书籍 栏 
目下 的 商品 信息 实现 代码 和 上 面 代码 大 同 小 异 。 商 品 列表 页 面 如 图 14-16 所 示 。 


< 


14-16 ”二 级 栏目 下 的 商品 信息 展示 页 面 


14.6.2 ”获取 特定 的 商品 信息 


上 面 是 以 列表 的 信息 展示 了 每 个 二 级 栏目 下 的 商品 信息 , 但 是 如 果 要 查看 具体 的 一 条 商品 
信息 怎么 办 呢 ? 以 下 是 这 一 实现 方式 的 操作 步骤 。 

(1) 对 商品 名 称 设置 超 链接 ， 例 如 对 音像 制品 栏目 下 的 商品 名 称 设置 超 链 接 为 : 
product/product!findProById.action?product.1d=<s:property value="#shu.id"/>&product.langType=< 
s:property value="#session.lang"/>。 其 中 ， 需 要 把 商品 信息 的 Id 传 给 ProductAction 类 中 的 
findProById0) 方 法 ,product.id 的 值 为 <s:property value="#shu.id"/>,“shu” 是 页 面 中 遍历 “shus” 
集合 时 设置 的 var 属性 值 。 

(2) 在 ProductAction 中 编辑 findProById0 方 法 ， 根 据 传 过 来 的 商品 Id 查询 特定 的 商品 信 
息 并 展示 在 页 面 上 ， 代 码 如 下 。 

// 前 台 点 击 商品 名 称 ， 显 示 具 体 的 商品 信息 

public String findProById(){ 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest (); 
// 调 用 业务 层 方 法 ， 获 取 特 定 的 商品 信息 


Products products = productService.getProById(product.getId()); 

// 获 取 商 品 简介 ， 读 取 页 面 

String pathDb = ServletActionContext .getServletContext () .getRealPath( 
products.getIntro()); 

Products .setIntro (ReadOutFile.readFile (pathDb)); 

// 把 查询 到 的 商品 信息 保存 至 HttpservletRequest 对 象 中 

request.setAttribute("pro", products); 

// 保 存 语言 类 型 

request .getSession() .setAttribute("lang",product .getLangType ()); 

Fetarn “theprors 
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(3) 在 struts-config 文件 夹 下 的 productxml 文件 中 配置 “thePro” 的 结果 页 面 ， 配置 如 下 。 
<result name="thePro">/product.jsp</result> 


(4) 在 根 目录 下 新 建 productjsp 页 面 ， 显 示 HttpServletRequest 对 象 中 保存 的 “pro” 所 对 
应 的 商品 信息 。 代 码 片段 如 下 。 


<table cellpadding="0" cellspacing="1" border="]1" class="table" width="430px" 
height="420px"> 
<s:if test="#request.pro!=null"> 
<tr> 
<td width="150" height="250"> 
<!---- 商 品 图 片 --> 
<div style="width: 150px; clear: both; height: 200px;"> 
<img src="<s:property value="#request.pro.pic" />" 
width="150" height="150" /> 
</div> 
<!---- 商 品 图 片 结束 --> 
</td> 
<td> 
<ul> 
<li class="1iGoods"> 
<s:if test="#session.lang.equals(\"zh\")"> 商 品名 称 : 


</s:if> 
<s:else>Product Name:</s:else> 
<s:property value="#request.pro.name" /> 
</1i> 
<li class="1iGoods"> 
<s:if test="#session.lang.equals(\"zhN")"> 商 品 编号 : 
</s:if> 
<s:else>Product Number:</s:else> 
<s:property value="#request.pro.number" /> 
</1i> 
<li class="liGoods"> 
<s:if test="#session.lang.equals(\"zh\") "> 商品 价 
格 :</s:if> 


<s:else>Product Price:</s:else> 
<s:property value="#request.pro.price" /> 元 
去 /> 
<1i class="1iGoods"> 
特色 服务 : <img src="images/service.gif" width="25" 
height="21" style="display: inline; vertical-align: middle;" /> 
</1i> 
<1i class="showTip"> 
images/service.gif" width="30" height="26" 


<img src 
style="display: inline; vertical-align: middle;" /> 
品质 保证 ， 无 理由 退换 货 ! 
</1i> 
</ul> 
</td> 


< 
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</tr> 
人 
<td colspan="2" style="border: lpx; border-color: #000; height: 
180px; vertical-align: top;"> 


<p style="word-break: break-all; vertical-align: top;"> 


escape="false"/> 


</p> 
</td> 
<WErS 
</s:if> 
ET 
<tr> 
<td> 
<s:if test="#session.lang.equals(\"zh\")"> 暂 无 商品 </s:if> 
<s:else>No products </s:else> 
</td> 
</tr> 
</s:else> 
</table> 


商品 列表 页 面 中 的 商品 名 称 ， 跳 转 至 productjsp 页 面 ， 如 图 14-17 所 示 。 


14-17 ”查看 特定 的 商品 信息 


14.7 后 台 模 块 一 一 信息 管理 


这 个 模块 包含 了 企业 简介 、 培 训 招生 、 在 线 视频 、 联 系 我 们 、 友 情 链接 、 太 极 感悟 和 太极 


风采 7 个 栏目 的 信息 管理 ， 根 据 数据 表 结构 可 以 把 将 这 7 个 栏目 规划 为 信息 管理 、 友 情 链 接 、 
太极 感悟 和 太极 风采 4 个 模块 进行 管理 。 
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14.7.1 信息 管理 


根据 数据 表 结构 可 以 将 企业 简介 、 培 训 招 生 、 在 线 视频 和 联系 我 们 4 个 栏目 信息 规划 到 信 
息 管理 模块 中 来 进行 统一 管理 。 

前 面 提 到 Messages 表 中 包含 了 多 个 栏目 信息 ， 其 中 包括 企业 简介 、 培 训 招生 、 在 线 视频 
和 联系 我 们 4 个 栏目 ， 这 4 个 栏目 的 信息 结构 是 相同 的 ， 只 需要 用 “msgType” 字 段 来 区 分 不 
同 的 栏目 即 可 ， 其 中 ，msgType 为 2 表示 的 是 企业 简介 栏目 、3 表示 的 是 联系 我 们 栏目 、4 表 
示 的 是 培训 招生 栏目 、5 表示 的 是 在 线 视 频 栏 目 。 

(1) 在 MessageAction 类 中 重 写 com.opensymphony.xwork2.ActionSupport 类 中 的 execute() 
方法 ， 在 该 方法 中 调用 业务 层 方法 ， 实 现 条 件 查 询 功 能 ， 代 码 如 下 。 

// 查 询 所 有 的 信息 ， 包 括 企业 简介 、 在 线 视频 、 联 系 我 们 和 培训 招生 4 个 栏目 信息 


public String execute() throws Exception { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest (); 
PageBean pageBean = (PageBean) request.getSession() .getAttributel( 
"pageBean") 7 

if (pageBean == null) { 

pageBean = new PageBean(); 
3 
String mark = ""; 
if (request.getParameter("mark") != null) { 

mark = request.getParameter ("mark"); 
} else { 

mark = "f"; 
} 
int tempNumber = 0; 
if (request.getParameter("number") != null) { 

tempNumber = Integer 

-parseInt (request .getParameter ("number") .trim()); 

. 
String hqlstring = "";// 存储 不 同 的 sql 语句 
String signstring="";// 存 储 选 中 的 一 级 菜单 
String sign="";// 页 面 跳 转 时 要 传 的 参数 
// 如 果 是 根据 不 同 的 条 件 进行 查询 的 信息 


if (request .getParameter ("sign") !=null&&request .getParameter ("Sign") !="" 


{ 
// 如 果 根 据 栏目 查询 不 同 的 信息 
if (request .getParameter ("msgstring") != 
null&g&request .getParameter ("msgstring")!="") { 
request.setAttribute ("msgstring", 
request .getParameter ("msgString") );// 保 存 选中 的 所 属 栏目 
// 记 录 条 件 类 型 


< 
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signstring="msgType"; 
// 记 录 参 数 
sign="msgstring="+request.getParameter ("msgstring"); 
hqlstring = " where msgType=" 
+ 


Integer.parseInt (request .getParameter ("msgString") ) 7 


} 


// 如 果 根 据 语言 查询 不 同 的 信息 
else if (request.getParameter ("1angString") 
nullggrequest .getParameter ("langString")!="") { 


signstring="langType"; 

sign="langSstring="+request.getParameter ("langstring"); 

request.setAttribute ("langstring", 
request .getParameter ("langstring")); 

// 如 果 用 户 选择 的 查询 条 件 是 “栏目 ”， 则 查询 企业 简介 、 培 训 招生 、 联 系 我 们 和 
在 线 视频 4 个 栏目 中 的 信息 

hqlstring = " where langType="'" 

+ request.getParameter ("langString") + "' and msgType 

in (2,3,4,5)"; 


} 
// 调 用 业务 层 方法 ， 获 取 查询 到 的 信息 ， 分 页 显示 
pageBean = 
msgService.selectMessagesNewsAll (PageCtr.PageCtrUpdatel 
pageBean, mark, tempNumber), hqlstring); 


} 

// 如 果 不 根据 条 件 查 询 ， 查 询 全 部 信息 

else { 

pageBean = 
msgService.selectMessagesNewsAll (PageCtr.PageCtrUpdate( 
pageBean, mark, tempNumber), "", ""); 
signstring="all"; 

// 把 页 面 跳 转 至 不 同 页 码 时 传 过 来 的 参数 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("sendpage", request.getParameter ("sign")); 
// 把 新 赋值 后 的 sign 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("sign", sign); 
// 把 条 件 类 型 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("signstring", signstring); 
// 把 查询 到 的 信息 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("msgs", pageBean.getResult ()); 
pageBean.setResult (null); 
request .getSession() .setAttribute ("pageBean", pageBean); 
return "msgIndex"; 


| 
(2) 在 struts-config 文件 夹 下 的 message xml 文件 中 配置 “msgIndex” 的 结果 页 面 , 配置 如 下 。 


<result name="msgIndex">/admin/message/index.jsp</result> 


mm >> 
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(3) 在 message 文件 夹 下 新 建 mdex.jsp 页 面 , 显示 查询 到 的 结果 数据 列表 。 代码 片段 如 下 。 


<table class="table" cellspacing="1"” cellpadding="2" width="100%" 
align="center" border="0"> 
< 


<th height="25" colspan="8" align="left" class="man" style="font-size: 
14px;color: #1E5494; "> 查询 条 件 : 
<select name="sign" id="sign" onchange="search()"> 
<option value="0">--- 请 选择 查询 条 件 ---</option> 
<option Value="msgTYPe" > 所 属 栏目 </option> 
<option langType"> 语 言 </ option> 
<option value= all"> 全 部 </option> 
</select> 
<div id="divmsg" style="display: none;"> 
<select name="msg" id="msg" onchange="checkmsg (this.value)"> 
<option value="0">--- 请 选择 所 属 栏目 ---</option> 
<s:iterator value="{' 企 业 简介 ',' 联 系 我 们 ',' 培 训 招 生 '，' 在线 视 


频 ' }" status="vs" var="item"> 


<option value="<s:property value="#vs.count+1"/>" 
<s:if test="#request.msgString==#vs .count+1"> 
selected="selected" 
</s:if> 
><s:property value="#item"/></option> 
</s:iterator> 
</select> 
</div> 
<div id="divlang" style="display: none;"> 
<select name="lang" id="lang" 
onchange="checklang (this.value)"> 
<s:if test="#request.langString.equals (\"zh\")"> 
<option value="zh" selected="selected">--- 中 文 


---</option> 
<option value="en">--- 英 文 ---</option> 
</s:if> 
<s:elseif test="#request.1angString.equals(\"en\")"> 
<option value="zh">--- 中 文 ---</option> 
<option value="en" selected="selected">--- 英 文 
—--</option> 
</s:elseif> 
<I2e13e> 
<option value="0" selected="selected">--- 请 选择 语言 类 型 
—--</option> 
<option value="zh">--- 中 文 ---</option> 
<option value="en">--- 英 文 ---</option> 
</S3EGLSE> 
</select> 
</div> 


<div id="divsign" style="display: inline;color: red;"></div> 
</th> 


怀 人 mm 
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<AEr 
<tr> 
<th height="25" colspan="4" align="left" class="man"> 
信息 管理 
</th> 
<th height="25" align="right" class="addMsg" colspan="4"> 
添加 信息 </a> 
</th> 
</tr> 
> 区 
<td class="td bg" width="15%" height="25"> 
<div align="center"> 信 息 标题 </div> 
</td> 
<td class="td bg" width="15%"> 
<div align="center"> 创 建 时 间 </div> 
</td> 
<td width="10%" class="td bg"> 
<div align="center"> 创 建 人 </div> 
</td> 
<td class="td bg" width="15g%"> 
<div align="center"> 所 属 栏目 </div> 
</td> 
<td width="15%" class="td bg"> 
<div align="center"> 文 章 导读 </div> 
</td> 
<td width="10%" class="td bg"> 
<div align="center"> 语 言 </div> 
</td> 
<td class="td bg" width="10%"> 
<div align="center"> 编 辑 </div> 
</td> 
<td class="td bg" width="10%"> 
<div align="center"> 删 除 </div> 
</td> 
</tr> 
<s:if test="#request.msgs.size()!=0"> 
<s:iterator value="#request.msgs" var="msg"> 
中 
<td height="25" style="color: #993333;"> 
<s:if test="#msg.name.trim() .Jength()>30"> 
<s:property 
value="%{#msg.name.substring (0,30)}"/>" /BES 
<s:else> 
<s:property value="#msg.name"/> 
</s elae> 
</td> 
<td><s:date name="#msg.createTime™" 
format="yyyy-MM-dd"/></td> 
<td><s:property value="#msg.createUser"/></td> 
<td class="td bg"> 
<s:if test="#msg.msgType==2"> 企 业 简介 </s:if> 
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<s:elseif test="#msg.msgType==3"> 联 系 我 们 </s:elseif> 
<s:elseif test="#msg.msgType==4"> 培 训 招 生 </s:elseif> 
<s:elseif test="#msg.msgType==5"> 在 线 视频 </s:elseif> 
</td> 
<td> 
<s:if test="#msg.headMsg.trim() .length()>30"> 
<s:property 
value="%{#msg.headMsg.substring(0,30)}" />… 
</s3:1F> 
<s:else> 
<s:property value="#msg.headMsg"/> 
</s:else> 
</td> 
<td class="td bg"> 
<s:if test="#msg.langType.equals (\"zh\")"> 中 文 </s:if> 
<s:else> 英 文 </s:else> 
</td> 
<td width="10%">【 编 辑 】</td> 
<td width="10%">【 删 除 】</ta> 
</tr> 
</s:iterator> 
直人 
<s:else> 
<tr> 
<td colspan=" 
</tr> 
</s:else> 
<s:if test="#request.msgs.size()!=0"> 
<> 
<th class="bg tr" align="right" colspan="8" height="25"> 
<s:push value="#request .session.pageBean"> 共 <span 
class="red"><s:property value="totalCount" /></span> 条 记录 当前 第 <span 
class="red"><s:property value="nowpage+1l" /></span>/<s:property 
value="totalpage"” /> 页 每 页 <s:property value="pagesize" /> 条 数据 
</s:push> 
<s:if test="#request.sendpage==null"> 


" align="center" height="25px"> 暂 无 数据 </td> 


<s:a 
href="message/message.action?%{#request .sign} gmark=f&number=0"> 首 页 </s:a> 
<s:a 
href="message/message.action?%{#request.sign}&mark=p&number=0"> 上 一 页 </s:a> 
<s:a 


href="message/message.action?%{#request .sign}&mark=n&number=0"> 下 一 页 </s:a> 
< 
href="message/message.action?%{#request .sign}&mark=l&number=0"> 尾 页 </s:a> 
A 
天 SEE 人 > 
<s:a 
href="message/message.action?sign=search&%{#request.sign}&mark=fg&number=0"> 


首页 </s:a> 


< 
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<s:a 
href="message/message.action?sign=search&%{#request.sign}&mark=p&gnumber=0"> 
J UE 

<s:a 
href="message/message.action?sign=search&%{#request.sign}&mark=ngnumber=0"> 
下 一 页 </s:a> 

<s:a 
href="message/message.action?sign=search&%{#request.sign}&mark=l&number=0"> 
尾 页 </s:a> 

</s:else> 
</th> 
</tr> 
</s:if> 
</table> 


(4) 在 本 页 面 中 添加 JavaScript， 代 码 如 下 所 示 。 


<script type="text/javascript"> 
function search(){ 
Var tiao=document .getElementById("sign") .value; 
if (tiao==0){ 
document .getElementById("divmsg") .style.display="none"; 
document .getElementById("divlang") .style.display="none"; 
document .getElementById ("divsign") .innerHTML=" 请 选择 您 要 查询 的 条 件 !1"; 
} 
elsef{ 
if (tiao=="all"){ 
window.location.href="message/message.action"; 
} 
else if(tiao=="msgType"){ 
document .getElementById("divmsg") .style.display="inline"; 
document .getElementById("divlang") .style.display="none"; 
}elsef{ 
document .getElementById("divmsg") .style.display="none"; 
document .getElementById("divlang") .style.display="inline"; 
和 


document .getElementById ("divsign") .innerHTML=""; 


} 
function checkmsg (msgString) { 
if (msgstring==0){ 
document .getElementById ("divsign") .innerHTML=" 请 选择 所 属 栏目 名 称 ! "; 
} 


elsef{ 


window.location.href="message/message.action?sign=search&gmsgString="+ms 
gstring; 
3 
} 
function checklang (langstring){ 
if(langstring==0){ 
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document .getElementById ("divsign"). innerHTML=" 请 选择 语言 类 型 (a 


}elsef{ 


window.location.href="message/message.action?sign=search&langstring="+1 
angstring; 
b 
} 
</script> 


下 面 来 测试 一 下 运行 效果 。 单 击 后 台 管 理 系统 首页 信息 管理 模块 中 的 信息 管理 模块 ， 出 现 
如 图 14-18 所 示 的 界面 。 


14-18 ”信息 管理 初始 化 界面 


选择 左上 角 “ 查 询 条 件 ” 下 拉 列 表 框 中 的 所属 栏目 ?选项 ,执行 MessageAction 中 的 execute() 
方法 ， 查 询 出 Messages 表 中 的 企业 简介 、 培 训 招 生 、 在 线 视频 和 联系 我 们 4 个 栏目 下 的 所 有 
信息 ， 并 分 页 显示 ， 如 图 14-19 所 示 。 再 次 选择 “-- 请 选择 所 属 栏目 一 ”下 拉 列 表 框 中 的 “ 企 
业 简介 ”选项 ， 还 是 执行 MessageAction 类 中 的 execute0 方 法 ， 查 询 条 件 为 “msgType=2” 的 
所 有 信息 ， 即 企业 简介 信息 ， 如 图 14-20 所 示 。 


nt 


图 14-19 ”查询 条 件 为 所 属 栏目 图 14-20 ”查询 条 件 为 企业 简介 


< 二 mm 
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上 面 演示 了 查询 条 件 为 “所 属 栏目 ”的 信息 管理 界面 效果 实例 ， 还 可 以 根据 语言 类 型 来 进 
行 查询 ， 这 里 不 再 演示 。 至 于 信息 的 添加 、 更 新 和 删除 ， 和 上 面 的 实现 思路 一 样 ， 这 里 不 再 做 
详细 讲解 。 


14.7.2 ”友情 链接 


通过 一 个 网 站 的 友情 链接 可 以 转 到 其 他 网 站 , 这 是 一 个 成 功 的 企业 网 站 中 不 可 或 缺 的 一 个 
模块 。 

(1) 在 com.dwtj.actions 包 下 新 建 FriendLinkAction 类 ， 继 承 自 com.opensymphony.xwork2. 
ActionSupport 类 ， 并 重 写 父 类 的 execute0 方 法 ， 获 取 友 情 链接 信息 列表 ， 方法 的 实现 代码 如 下 
所 示 。 


// 查 询 出 所 有 的 友情 链接 信息 
public String execute () throws Exception { 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest (); 
// 调 用 业务 层 方法 ， 获 取 友情 链接 信息 列表 
List<FriendLink> friendList = fLinkService.getLinkList(); 
// 把 获取 到 的 列表 信息 保存 至 HttpservletRequest 对 象 中 
request.setAttribute("friendList", friendList); 
return "index"; 


} 


(2) 在 strmts-config 文件 夹 下 新 建 friendlink.xml 文 件 , 并 配置 FriendLinkAction 类 及 “index” 
的 结果 页 面 ， 配 置 如 下 。 


<package name="friendlink" namespace="/friendlink" extends="ma"> 
<action name="friendlink" class="com.dwtj.actions.FriendLinkAction"> 
<result name="index">/admin/friendlink/index.jsp</result> 
</action> 
</package> 


(3) 在 admin 文件 夹 下 新 建 friendlink 文件 夹 ， 并 在 该 文件 夹 下 新 建 mdexjsp 页 面 ， 显 示 
友情 链接 所 有 数据 信息 ， 代 码 片段 如 下 。 


<s:if test="#request.friendList.size()!=0"> 
<s:iterator value="#request.friendList" var="fl"> 
<tr> 
<td height="25"><s:property value="#f1.title"/></td> 
<td class="td bg"> 
<s:if test="#fl.addressUrl.trim() .length()>20"> 
<s:property value="%{#f1.addressUrl .substring(0,20)}" 
/> 
</s:if> 
<s:else><s:property value="#fl.addressUrl" /></s:else> 
</td> 
<td> 
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<img src="<s:property value="#fl1.imgUrl" />" width="40px" 
height="30px"> 
</td> 
<tqd class="tqd bg">【 编 辑 】</td> 
<td>【 删 除 】</ta> 
</tr> 
</s:iterator> 
2 
<s:else> 
EE 
<td colspan="5" class="td bg" height="25px"> 暂 无 友情 链接 信息 </td> 
NET 
</s:else> 


友情 链接 模块 的 运行 效果 如 图 14-21 所 示 。 


14-21 ”后台 模块 中 的 友情 链接 管理 界面 


太极 感悟 、 太 极 风 采 、 评 论 管 理 和 幻灯 片 管理 的 实现 ， 这 里 不 再 详细 讲解 ， 它 们 都 是 独立 
的 表 ， 代 码 的 实现 非常 简单 ， 读 者 可 以 查看 本 案例 中 的 源码 实现 代码 来 做 进一步 的 了 解 。 


14.8 ”前 台 展示 一 一 在 线 视频 
通过 后 台 的 编辑 视频 ， 浏 览 者 可 在 前 台 在 线 观 看 视频 内 容 。 由 于 视频 数据 比较 多 ， 这 里 采 
用 列表 形式 显示 数据 。 


14.8.1 获取 视频 列表 信息 


(1) 在 MessageAction 类 中 编辑 getVideo0 方 法 , 调用 业务 层 方法 获取 视频 列表 , 代码 如 下 。 
// 获 取 视频 列表 信息 


public String getVideo(){ 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest () 7 


< 
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PageBean pageBean = (PageBean) request .getSession() .getAttributel( 
"pageBean") 7 

null)y { 

new PageBean () 7 


if (pageBean 


pageBean 


} 


String mark = ""; 

if (request.getParameter ("mark") != null) { 
mark = request.getParameter ("mark"); 

} else { 


mark = "f"; 
} 
int tempNumber = 0; 
if (request.getParameter("number") != null) { 
tempNumber = Integer 
-parseInt (request .getParameter ("number") .trim()); 


} 

// 调用 业务 层 分 页 显示 数据 

pageBean = msgService.selectVideoAll (PageCtr.PageCtrUpdate( 
pageBean, mark, tempNumber), ""); 

request.setAttribute("msgs", pageBean.getResult ()); 

pageBean.setResult (null); 

request .getSession() .setAttribute ("sign"，"video");// 获 取 标 识 

request .getSession() .setAttribute ("pageBean", pageBean); 

Tequest .getSession() .setAttribute("lang", msg.getLangType()); 

// 获取 语言 

return "newsList"; 


} 
(2) 在 struts-config 文件 夹 下 的 message.xml 文件 中 配置 “newsList” 结 果 页 面 , 配置 如 下 。 
<result name="newsList">/newList.jsp</result> 


(3) 在 根 目录 下 新 建 newListjsp 页 面 , 遍历 视频 列表 信息 , 输出 视频 信息 , 代码 片段 如 下 。 


<s:if test="#request.msgs.size()!=0"> 
<s:iterator value="#request .msgs" var="msg"> 
<s:if test="#msg.name.trim() .length()>25"> 
<s:property value="%{#msg.name.substring(0,25)}" />… 
</s:if> 
<s:else> 
<s:property value="#msg.name" /> 
</sselse> 
</s:iterator> 
</s: if> 
<s:else> 
暂 无 信息 


<Lsselae> 


运行 程序 ， 视 频 列 表 页 面 如 图 14-22 所 示 。 
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14-22 ”视频 列表 页 面 


14.8.2 ”获取 特定 的 视频 信息 


单 击 视频 列表 中 的 视频 名 称 ， 显 示 特定 的 视频 信息 ， 以 供 浏览 者 查看 视频 内 容 。 
<a style="cursor: pointer;" href="message/message!findNewById.action?msg.id= 
<s:property value="#msg.id"/>gmsg.langType=<s:property 
value="#session.lang"/>&sign=<s:property value="#session.sign"/>"> 
<s:if test="#msg.name.trim() .length()>25"> 
<s:property value="%{#msg.name.substring(0,25)}" />… 
</ssiE> 
<Ielsex 
<s:property value="#msg.name"/> 
</s:else> 
</a> 


从 超 链接 地 址 来 看 , 这 里 要 访问 的 是 MessageAction 类 中 的 findNewById0 方 法 , 并 将 视频 


Id 传递 给 了 这 个 方法 , 这 个 方法 就 是 前 面 14.4.2 节 中 讲 到 的 findNewById0 方 法 , 这 里 不 再 袭 述 。 


测试 一 下 效果 ! 单 击 视频 列表 页 面 中 的 视频 名 称 ， 出 现 如 图 14-23 所 示 的 界面 。 


图 14-23 显示 特定 的 视频 信息 


< 
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14.9 ”前 台 展示 一 一 友情 链接 


单 击 前 台 页 面 中 的 “友情 链接 ”栏目 ， 显 示 友 情 链 接 数据 ; 单 击 友情 链接 信息 中 的 图 片 ， 


在 新 窗口 中 打开 连接 到 的 网 页 。 


(1) 在 FriendLinkAction 类 中 编辑 getLinkUrl0 方 法 ， 获 取 友情 链接 数据 ， 代 码 如 下 。 


// 获 取 友 情 链接 信息 

public String getLinkUrl(){ 
// 获 取 HttpservletRequest 对 象 
HttpServletRequest request = ServletActionContext.getRequest () 7 
// 调 用 业务 层 方法 获取 友情 链接 列表 
List<FriendLink> friendList = fLinkService.getLinkList(); 
request.setAttribute("friendList", friendList); 
Tequest .getSession() .setAttribute("lang", 

request .getParameter ("lang")); 

return "linkurl"; 


} 
(2) 在 struts-config 文件 夹 下 的 friendlink.xml 文件 中 配置 “linkurl” 的 结果 页 面 , 配置 如 下 。 
<result name="linkurl">/friend link.jsp</result> 
(3) 在 项 目的 根 目录 下 新 建 friend_link.jsp 页 面 ， 显 示 友 情 链 接 信息 ， 代 码 片段 如 下 。 


<s:if test="#request.friendList.size()!=0"> 
<s:iterator value="#request.friendList" var="fl"> 
<a href="<s:property value="#fl.addressUr1l"/>" target=" blank"> 
<img src="<s:property value="#f1.imgUrl"/>" alt="<s:property 
value="#fl1 .addressUr1l"/>"/> 
<div style="background-color: 
black;color:red;width:150px;line-height: 
25px;overflow:hidden;float:left;font-size:1l4px;cursor: pointer;"> 
<s:if test="#f1 .title.trim() .length()>10"> 
<s:property value="%{#f1.title.substring(0,10)}" />... 
</a:1f> 
<s:else> 
<s:property value="#fl1.title" /> 
</s:else> 
</div> 
</a> 
</s:iterator> 
/asify 


<s:else> 暂 无 友情 链接 </s:else> 
(4) 运行 程序 ， 单 击 “ 友 情 链接 ”栏目 ， 跳 转 至 friend_link.jsp 页 面 ， 如 图 14-24 所 示 。 
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14-24 ”友情 链接 界面 


单 击 友情 链接 列表 页 面 中 的 图 片 , 在 新 窗口 中 打开 链接 的 网 页 , 这 个 超 链接 是 动态 加 载 的 ， 
数据 表 中 有 一 个 字段 用 来 存储 链接 路 径 。 


14.10 总 结 


世上 无 难事 ， 只 怕 有 心 人 。 当 你 看 到 要 做 一 个 企业 网 站 ， 你 可 能 会 有 一 点 点 的 胆 导 ， 觉 得 
做 一 个 网 站 花费 的 精力 太 多 ， 要 实现 的 功能 也 太 多 。 当 你 看 到 项 目 需求 分 析 时 ， 发 现 有 的 功能 
你 不 会 ， 事实 上 ， 这 个 网 站 很 简单 ， 没 必要 恐惧 它 ， 相 信 自己 。 

由 于 ， 本 案例 中 的 登录 功能 和 其 他 系统 的 功能 实现 完全 一 样 ， 这 里 并 没有 做 详细 的 介绍 。 
本 案例 中 的 用 户 表 里 面 存放 有 管理 员 信息 和 会 员 信息 ， 当 会 员 登录 后 台 管 理 系统 时 ， 系 统 会 进 
行 拦截 ,会 员 是 无 法 登录 到 后 台 管理 系统 的 。 当 管理 员 在 已 经 登录 的 状态 下 再 次 登录 时 ， 系 统 
也 会 进行 拦截 ， 不 让 其 重复 登录 。 

在 案例 中 ， 多 处 用 到 分 页 技术 。 分 页 技术 有 多 种 方法 都 可 以 实现 ， 例 如 jQuery。 

FCKEditor 现在 是 Web 开发 中 最 常用 的 文本 编辑 器 ， 它 的 使 用 非常 简单 ， 我 也 为 读者 讲解 
过 ， 如 果 你 想 换 皮肤 或 者 设置 FCKEditor 的 其 他 属性 ， 都 可 以 通过 它 的 配置 文件 进行 修改 。 

-个 人 是 否 有 程序 员 的 潜质 ， 就 看 自己 怎么 对 待 自己 的 工作 了 。 困 难 并 不 可 怕 ， 可 怕 的 是 
没有 一 颗 自信 、 上 进 的 心 。 


< 多 mm 


内 容 摘 要 : 


在 信息 社会 中 ， 随 着 电脑 与 网 络 技术 的 日 益 发 达 ， 电 子 商 务 空前 发 展 ， 企 业 之 间 的 竞争 也 
从 有 形 的 市 场 逐 渐 转 向 了 虚拟 的 网 络 ， 相 应 的 企业 管理 也 进入 了 信息 化 ， 人 力 资源 管理 系统 由 
此 诞生 。 人 力 资源 管理 系统 是 企业 管理 平台 (ERP) 的 重要 组 成 部 分 ， 是 为 了 提高 企业 的 管理 水 
平 而 设计 和 开发 的 管理 信息 系统 。 其 设计 的 目标 是 实现 对 企业 人 力 资 源 信息 的 统一 管理 ， 用 于 
支持 决策 ， 满 足 用 户 及 时 沟通 需要 ， 实 现 与 其 他 系统 的 协同 。 

在 本 章 的 人 力 资源 管理 系统 中 ， 将 严格 遵循 系统 开发 流程 ， 结 合 前 面 章节 所 学 知识 ， 运 用 
Ajax 技术 进行 异步 提交 数据 ， 使 用 CSS 控制 页 面 显 示 样 式 ， 客 户 端 页 面 是 JSP 动态 实现 ， 系 
统 整体 采用 Struts 2+Hibernate+Spring(SSH) 整 合 的 开发 模式 。 

学 习 目 标 : 

@ 掌握 系统 需求 分 析 的 过 程 。 
掌握 人 力 资源 管理 系统 的 数据 库 设计 。 
掌握 Struts+Spring+Hibernate 开发 模式 。 
掌握 Struts、Spring 配置 文件 中 的 配置 项 。 
掌握 Hibernate 映射 文件 的 编写 。 

了 解 业 务 控 制 器 Action 的 使 用 。 
理解 SSH 开发 应 用 。 
熟悉 MyEclipse 的 使 用 。 
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15:1 系统 分 析 


系统 分 析 包 括 系统 需求 分 析 和 系统 可 行 性 分 析 。 从 系统 需求 分 析 中 ， 主 要 了 解 系统 的 性 
能 需求 和 功能 需求 ， 从 系统 可 行 性 分 析 中 ， 主 要 了 解 系统 的 经 济 效益 和 系统 构建 时 的 技术 的 可 
行 性 。 


15.1.1 系统 需求 分 析 


人 力 资源 管理 系统 是 一 个 企 事业 单位 不 可 少 的 部 分 ， 它 对 决策 者 和 管理 者 来 说 都 至 关 重 
要 ， 因 为 人 力 资源 管理 系统 应 该 能 够 为 用 户 提 供 充 足 的 信息 和 快捷 的 查询 。 但 是 一 直 以 来 ， 人 
们 都 是 使 用 人 工 的 方式 来 管理 文件 档案 ， 这 种 管理 方式 有 很 多 缺点 ， 如 : 效率 低 、 保 密 性 差 ， 
时 间 一 长 ， 将 会 产生 大 量 的 数据 和 文件 ， 给 用 户 更 新 和 查找 带 来 了 很 大 的 困难 。 

作为 计算 机 应 用 的 一 部 分 ， 使 用 计算 机 对 人 事 信息 进行 管理 ， 具 有 手工 管理 无 法 比拟 的 优 
点 。 如 : 查询 方便 、 检 索 快 、 存 储量 大 、 保 密 性 好 、 成 本 低 等 。 这 些 优点 能 够 极 大 地 提高 企业 
的 人 事 管理 的 效率 ， 也 是 企业 的 正规 化 、 科 学 化 管理 的 重要 条 件 。 所 以 , 开发 一 个 稳定 、 高 效 、 
功能 完善 的 人 力 资 源 管理 系统 成 为 了 一 种 必要 。 

1. 性 能 需求 

-个 信息 管理 系统 ， 第 一 ， 要 有 很 好 的 稳定 性 和 可 维护 性 ， 第 二 ， 要 有 很 好 的 可 扩展 性 ， 
在 不 影响 基本 框架 的 前 提 下 , 增加 新 的 业务 逻辑 ,进行 二 次 开发 ; 第 三 , 要 有 很 好 的 可 移植 性 ， 
以 满足 不 同系 统 用 户 的 需求 ， 第 四 ， 要 尽 可 能 使 界面 美观 、 简 洁 、 操 作 简单 。 

2. 功能 需求 

人 力 资源 管理 系统 需要 人 力 资源 的 管理 不 受 地 点 、 时 间 的 限制 ， 只 要 能 够 上 网 ， 通 过 验证 
并 登录 系统 ， 便 能 够 查看 人 力 资源 信息 ， 进 行人 力 资源 信息 的 管理 和 更 新 。 人 力 资源 管理 系统 

| 具有 员工 管理 、 招 聘 管理 、 奖 惩 管理 、 培 训 管理 、 薪 资 管理 及 管理 员 模块 。 人 力 资源 部 门 负责 
添加 、 修 改 和 删除 各 类 信息 。 领 导 可 以 查询 各 类 信息 。 员 工 可 以 浏览 个 人 的 信息 。 


15.1.2 ”系统 可 行 性 分 析 


计算 机 网 络 作为 一 种 先进 的 信息 传输 媒体 ， 有 着 传送 信息 块 、 信 息 履 盖 面 广 、 成 本 低 的 优 
点 。 因 此 ， 很 多 的 企业 开始 利用 网 络 开展 商务 活动 ， 可 以 看 到 ， 在 企业 进行 的 网 上 商业 活动 所 
产生 的 效益 是 多 方面 的 。 但 是 ， 开 发 一 个 基于 计算 机 的 系统 ， 都 会 受到 资源 和 时 间 的 限制 。 因 
此 ， 在 接受 任何 一 个 项 目 开发 任务 之 前 ， 必 须根 据 提供 的 时 间 和 资源 条 件 进 行 可 行 性 分 析 ， 以 
减少 项 目的 开发 风险 ， 避 免 人 力 、 物 力 和 财力 的 浪费 。 经 济 可 行 性 分 析 和 技术 可 行 性 分 析 在 很 
多 方面 是 相互 关联 的 ， 项 目 风 险 越 大 ， 开 发 高 质量 软件 的 可 行 性 就 越 小 。 


md >> 
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1. 经 济 可 行 性 

通过 网 络 化 的 人 力 资 源 管理 ， 大 大 地 提高 了 企业 人 才 的 利用 率 ， 使 之 为 企业 创造 了 更 大 的 
价值 。 人 才 利 用 率 的 提高 ， 增 强 了 企业 的 核心 竞争 力 ， 全 面 地 提升 了 企业 的 管理 能 力 ， 从 而 使 
企业 适应 了 信息 时 代 的 网 络 化 管理 要 求 。 

2. 技术 可 行 性 

开发 此 系统 需要 的 环境 有 如 下 几 点 。 

@ 操作 系统 : Windows XP/Windows 2000。 

@ 数据库: Mysql5.0。 

@ 开发 工具 : MyEclipse8.5。 

@ 服务器: Tomcat。 

基于 编程 开发 语言 是 Java、JSP， 因 此 ， 需 要 开发 人 员 熟 练 使 用 Java、JSP 语言 ， 需 要 开 
发 人 员 熟 练 使 用 相关 数据 库 的 操作 ， 开 发 人 员 需 要 具有 一 定 的 数据 库 开 发 功底 和 编程 能 力 。 优 
美的 界面 设计 再 加 上 Windows 稳定 的 运行 环境 的 支持 和 开发 人 员 的 过 硬 技术 ， 从 功能 和 性 能 
上 完全 可 以 满足 系统 的 要 求 ， 因 此 ， 从 技术 方面 此 系统 是 可 行 的 ， 综 合 以 上 两 方面 ， 开 发 此 系 
统 是 可 行 的 。 


15.2 系统 设计 


系统 设计 是 在 系统 分 析 的 基础 上 由 抽象 到 具体 的 过 程 , 主要 目标 是 将 系统 分 析 阶段 所 提出 
的 反应 信息 需求 的 系统 逻辑 方案 ,转换 成 可 以 实施 的 基于 计算 机 与 通信 系统 的 物理 方案 , 为 下 
-阶段 的 技术 实施 提供 必要 的 技术 资料 , 同时 须 符合 系统 性 、 灵 活性 、 可 靠 性 、 经 济 性 的 要 求 。 


15.2.1 总 体 设 计 


系统 总 体 设计 是 对 系统 的 模块 规划 、 系 统 功能 结构 和 数据 库 的 总 体 设 计 。 
1. 模块 规划 


人 力 资源 管理 系统 是 针对 员工 信息 管理 的 一 个 平台 ， 系 统 的 主要 功能 如 下 。 

@ 员工 管理 : 主要 包括 浏览 员工 信息 、 添加 员工 信息 、 修改 员工 信息 、 员 工 信 息 的 删除 。 
@ ”应 聘 管理 : 主要 包括 应 聘 人 员 信 息 的 查看 、 删 除 及 添加 信息 入 库 和 修改 应 聘 者 信息 。 
@ ”培训 管理 ， 主 要 包括 培训 计划 的 详细 信息 浏览 、 信 息 删除 、 添 加 和 修改 培训 计划 。 
@ 奖惩 管理 : 主要 包括 浏览 奖惩 的 详细 信息 、 添 加 信息 、 删 除 信息 、 修 改 信息 。 

@ 薪资 管理 : 主要 包括 浏览 薪资 的 详细 信息 、 薪 资 的 修改 、 添 加 、 删 除 。 
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.系统 功能 结构 
主要 模块 结构 图 如 图 15-1 所 示 。 
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15-1 功能 模块 图 


15.2.2 数据库 设计 


数据 库 在 一 个 信息 管理 系统 中 的 地 位 非常 重要 , 数据 库 结构 设计 的 好 坏 将 直接 对 应 用 系统 
的 效率 ， 实 现 的 效果 产生 影响 。 合 理 的 数据 库 结构 设计 可 以 提高 数据 存储 的 效率 ， 保 证 数据 的 
完整 和 一 致 。 

1. 数据 库 需求 分 析 


数据 库 系统 应 充分 了 解 用 户 各 方面 的 需求 ， 本 系统 用 户 的 需求 具体 体现 在 各 种 信息 的 提 
供 、 存 储 、 更 新 和 查询 ， 这 要 求 数据 库 的 结构 能 充分 满足 各 种 信息 的 输入 和 输出 。 收 集 基本 数 
据 、 数 据 结构 及 数据 的 处 理 流程 ， 为 后 面 的 具体 设计 打下 基础 。 

根据 系统 功能 分 析 和 和 需求 总 结 ， 考 虑 到 将 来 功能 上 的 扩展 ， 设 计 用 户 信息 表 、 管 理 员 信息 
表 、 培 训 信息 表 、 应 聘 信息 表 、 奖 惩 信息 表 、 薪 资信 息 表 。 

2。 数据 库 概念 设计 


根据 上 面 的 数据 项 和 数据 结构 ， 就 可 以 设计 出 能 够 满足 用 户 需求 的 各 种 实体 ， 为 以 后 的 逻 
辑 结 构 设计 打下 基础 。 因 此 ， 本 系统 的 实体 有 : 管理 员 实 体 、 员 工 实体 、 应 聘 实体 、 奖 惩 实体 、 
培训 实体 、 薪 资 实体 。 

3. 数据 库 逻 辑 结构 设计 


本 系统 选用 MySQL 数据 库 ， 在 MySQL 数据 库 中 ， 为 本 人 力 资源 管理 系统 建立 一 个 数据 
库 pmanager。 根 据 数据 库 的 概念 设计 ， 确 定 本 系统 需要 6 个 表 ， 分 别 是 : 管理 员 信息 表 、 员 工 
信息 表 、 应 聘 信息 表 、 奖 惩 信 息 表 、 培 训 信息 表 、 薪 资信 息 表 。 由 于 本 系统 的 持久 化 层 使 用 
Hibernate 技术 ，Hibernate 会 在 数据 库 中 自动 映射 生成 数据 表 ， 所 以 不 需要 手动 建立 。 在 这 里 
为 了 让 各 位 读者 更 加 明白 ， 简 要 介绍 一 下 各 个 表 的 结构 。 

1) “管理 员 信息 表 

管理 员 表 用 来 保存 管理 员 的 基本 信息 ， 管 理 员 表 中 主要 有 管理 员 id、 用 户 名 、 密 码 三 个 字 


段 。 管 理 员 信息 如 表 15-1 所 示 。 
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表 15-1 管理 员 表 admin 


字段 名 称 含义 类 型 约 束 
Id 管理 员 id Int 主键 
Adminname 用 户 名 Varchar 非 空 
Password 密码 Varchar 非 空 


2. 员工 信息 表 


员工 表 用 来 保存 员工 的 基本 信息 ， 员 工 表 中 主要 有 员工 id、 员工 姓名 、 密 码 、 性 别 、 电 话 、 
地 址 、 生 日 、 简 介 8 个 字段 。 员 工 表 信 息 如 表 15-2 所 示 。 


字段 名 称 


表 15-2 员工 信息 表 employee 


Content 


3. 应 聘 信 息 表 


员工 id Int 
员工 姓名 Varchar 


应 聘 信 息 表 用 来 保存 应 聘 的 人 员 的 基本 信息 ， 应 聘 表 中 主要 有 应 聘 者 id、 名 称 、 性 别 、 年 


龄 、 应 聘 职位 、 专 业 、 


表 15-3 所 示 。 


工作 经 验 、 学 历 、 学 校 、 电 话 、 邮 箱 、 简 介 12 个 字段 。 应 聘 表 信息 如 


表 15-3 应 聘 信息 表 apply 


Id 应 聘 者 id 主键 
Name 可 空 
Sex 性 别 Varchar 可 空 
Age 年 龄 Varchar 可 空 
了 Post 应 聘 职 位 Varchar 可 空 
Professional 专业 Varchar 可 空 
Experience 经 验 Varchar 可 空 
Education 学 历 Varchar 可 空 
School Varchar 可 空 
Tel Varchar 可 空 
Email Varchar 可 空 
Content Varchar 可 空 


< 
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4. 奖惩 信息 表 
奖惩 信息 表 用 来 保存 奖惩 的 基本 信息 ， 奖 惩 表 中 主要 有 奖惩 id、 奖惩 名 字 、 奖 惩 原因 、 奖 
惩 说 明 4 个 字段 。 奖 惩 表 信 息 如 表 15-4 所 示 。 
表 15-4 奖惩 信息 表 incentives 


字段 名 称 约束 
Id 
Jname Varchar 
Reason Varchar 
Jcontent Varchar 


5. 培训 信息 表 
培训 信息 表 用 来 保存 培训 的 基本 信息 ， 培 训 表 中 主要 有 培训 id、 培 训 名 称 、 培 训 目 的 、 培 
训 开始 时 间 、 培 训 结束 时 间 、 培 训 讲师 、 培 训 人 员 、 培 训 内 容 8 个 字段 。 培 训 表 信息 如 表 15-5 
所 示 。 
表 15-5 培训 信息 表 train 
字段 名 称 


图 
Trainname 

Target 
Startime 

Stoptime 结束 时 间 

Teacher 

Student Varchar 
Content Varchar 


6. 薪资 信息 表 
薪资 信息 表 用 来 保存 薪资 的 基本 信息 ， 薪 资 表 中 主要 有 薪资 id、 员 工 姓 名 、 基 本 工资 、 食 
补 、 房 补 、 全 勤 奖 、 罚 款 、 发 放 时 间 、 总 计 9 个 字段 。 薪 资 表 信息 如 表 15-6 所 示 。 
表 15-6 薪资 信息 表 pay 
字段 名 称 | 约束 


Id 薪资 id Int 主键 
Name 员工 姓名 Varchar 非 空 
Basic 基本 工资 Float 非 空 


Eat 可 空 
House 可 空 
Dnuty 可 空 
Othor 可 空 
Granttime 可 空 
Total 可 空 
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全 》 在 每 个 数据 表 中 ， 都 设置 一 个 自 增 列 。 一 方面 让 每 条 记录 信息 都 有 唯一 标识 符 ; 
技巧 另 一 方面 可 以 作为 外 键 ， 关 联 到 其 他 表 。 


15.3 ”系统 运行 和 开发 环境 的 搭建 


本 章 从 配置 项 目的 开发 环境 ， 到 整个 项 目的 完成 ， 都 是 以 SSH 整合 的 运用 进行 项 目 开发 
的 过 程 ， 所 以 只 要 读者 用 心 就 一 定 能 够 成 功 。 表 15-7 所 示 是 搭建 开发 环境 所 需 的 软件 ， 下 载 
后 进行 安装 、 配 置 环境 。 


表 15-7 环境 配置 及 开发 工具 软件 


在 开发 工具 MyEclipse 中 ， 创 建 一 个 名 为 Pmanager 的 Web 工程 ， 搭 建 好 运行 环境 。 本 人 
力 资 源 管理 系统 的 目录 结构 如 图 15-2 所 示 。 


ja 
= 
s 当 


15-2 ”人 力 资 源 管理 系统 目录 结构 图 


在 图 15-2 所 示 的 目录 结构 中 /action 中 存放 各 个 action 的 配置 文件 ，/bean 中 存放 各 个 bean 
文件 的 映射 配置 文件 ，com/pmanager/action 中 存放 各 个 模块 的 action，com/pmanager/dao 中 存 
放 各 个 数据 库 访 问 类 dao，com/pmanager/service 中 存放 各 个 模块 的 代理 类 service， 
com/pmanager/po 中 存放 各 个 表 的 实体 类 及 实体 类 的 hibernate 映射 文件 , com./zzu/util 中 存放 各 
种 使 用 工具 类 , ROOT 目录 下 保存 的 是 JSP 文件 和 相应 的 CSS 文件 和 图 片 , WebRoot/WEB-INF 
目录 下 是 web.xml 配置 文件 ，src 目录 中 存放 jdbc 资源 文件 和 SSH 的 Struts.xml、 
applicationContext.xml、Hibernate.cfg.xml 配置 文件 。 以 下 是 对 各 个 配置 文件 的 介绍 。 


< 


6 人 Web 开发 学 习 实录 . 忆 


15.3.1 web.xml 配 置 文件 


web.xml 是 web 应 用 中 加 载 有 关 Servlet 信息 的 重要 配置 文件 ， 起 着 初始 化 servlet、filter 
等 web 程序 的 作用 。 

每 一 个 xml 文件 都 有 定义 书写 规范 的 schema 文件 ，web.xml 所 对 应 的 xml Schema 文件 中 
定义 了 多 少 种 标签 元 素 ，web.xml 中 就 可 以 出 现 它 所 定义 的 标签 元 素 ， 也 就 具备 哪些 特定 的 功 
能 。web.xml 的 模式 文件 是 由 Sun 公司 定义 的 ， 每 个 web.xml 文件 的 根 元 素 为 <web-app> 中 ， 
必须 标明 这 个 web.xml 使 用 的 是 哪个 模式 文件 。 详 细 配 置 如 下 代码 。 


<?xml Version="1.0"” encoding="UTF-8"?> 
<web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:XSsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app 2 5.xsd"> 
<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:/spring.xml</param-value> 
</context-param> 
<listener> 


<listener-class>org.springframework.web.context.ContextLoaderListener</list 
ener-class> 
</listener> 
天 有 LEeE> 
<filter-name>Struts2</filter-name> 


<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareRAndExecu 
teFilter</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 
<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
</welcome-file-list> 
</web-app> 


15.3.2 ”struts.xml 配 置 文 件 


Struts 2 的 核心 配置 文件 是 缺 省 的 strutsl.xml, 这 个 文件 也 是 struts 2 框架 主动 加 载 的 文件 ， 
在 这 个 文件 中 可 以 定义 自己 的 一 些 action、interceptor、package 等 .Package 通常 继承 struts-default 
包 。Struts 文件 可 以 放 入 jar 中 ， 并 自动 插入 应 用 程序 ， 这 样 每 个 模块 可 以 包含 自己 的 配置 文件 
并 自动 配置 。 详 细 配 置 如 下 代码 。 
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<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd"> 
<struts> 
<constant name="struts.ognl.allowStaticMethodAccess" value="true" /> 
<!-- 更 改 struts2 的 标签 为 简单 样式 --> 
<constant name="struts.ui.theme" value="simple" /> 
<constant name="struts.ui.emplateDir" value="template" /> 
<constant name="struts.ui.templateSuffix" value="ftl" /> 
<constant name="struts.enable.SlashesInActionNames" value="true" /> 
<constant name="struts.mapper.alwaysSelectFullNamespace" value="false" /> 
<!-- 结合 spring 插件 --> 
<constant name="struts.objectFactory" value="spring"></constant> 
<constant name="struts.locale" value="en utf-8"></constant> 
<!-- 公用 的 jsp 映射 、--> 
<package name="jsp" extends="struts-default" namespace="/jsp"> 
<action name="**"> 
<result name="success">/WEB-INF/jsp/{1}.jsp</result> 
</action> 
</package> 
<package name="default" extends="struts-default"> 
<global-results> 
<result name="error">/WEB-INF/jsp/error.jsp</result> 
</global-results> 
</package> 
<include file="action/Main.xml"/> 
<include file="action/EmpManager.xml"/> 
<include file="action/AdminManager.xml"/> 
<include file="action/RecruitManager.xml"/> 
<include file="action/IncentivesManager.xml"/> 
<include file="action/TrainManager.xml"/> 
<include file="action/PayManager.xml"/> 
</struts> 


以 下 是 其 中 一 个 模块 的 struts 配置 文件 的 代码 。 


<?xml] version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts 
Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd"> 
<struts> 
<package name="AdminManager" extends="default" namespace="/admin"> 
<action name="main" class="adminManager" method="main"> 
<result name="success">/WEB-INF/jsp/Admin/main.jsp</result> 
</action> 
<action name="list" class="adminManager" method="list"/> 
<action name="add" class="adminManager" method="add"> 
<result name="success" type="redirect">main</result> 
</action> 
<action name="modify" class="adminManager" method="modify"> 
<result name="success" type="redirect">main</result> 
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</action> 
<action name="load" class="adminManager" method="load" /> 


</package> 
</struts> 


15.3.3 hibernate.cfg.xml 配 置 文 件 


Hibemate 主要 用 于 配置 数据 库 连 接 、 事 务 管理 ， 以 及 指定 Hibernate 本 身 的 配置 信息 和 
Hibernate 映射 文件 信息 。Hibernate 配置 文件 默认 以 hibernate.properties 或 者 hibernate.cfg.xml 
命名 ， 常 用 的 是 XML 格式 的 配置 文件 ， 这 个 配置 文件 应 该 位 于 应 用 的 classpath 中 。 有 具体 配置 
代码 如 下 所 示 。 

<session-factory> 

<property name="dialect"> 
org.hibernate.dialect .MySQLDialect 

</property> 

<property name="connection.url"> 
jdbc:mysql://localhost:3306/pmanager 

</property> 

<property name="connection.username">root</property> 

<property name="connection.password">root</property> 

<property name="connection.driver class"> 
com.mysql.jdbc.Driver 

</property> 

<property name="myeclipse.connection.profile">mysql</property> 

<property name="hibernate.show_ sql">true</property> 


<mapping resource="com/pmanager/po/Admin.hbm.xml" /> 
<mapping resource="com/pmanager/po/Company.hbm.xml" /> 
<mapping resource="com/pmanager/po/Employee.hbm.xml" /> 
<mapping resource="com/pmanager/po/Incentives.hbm.xml" /> 
<mapping resource="com/pmanager/po/Pay.hbm.xml" /> 
<mapping resource="com/pmanager/po/Recruitment.hbm.xml" /> 
<mapping resource="com/pmanager/po/Train.hbm.xml" /> 

</session-factory> 

</hibernate-configuration> 


15.3.4 applicationContext.xml 配 置 文件 


Spring 对 Hibemate 提供 了 良好 的 支持 ，Hibernate 的 配置 信息 完全 可 以 在 Spring 的 配置 文 
件 中 配置 。Hibernate 和 Spring 集成 使 用 ， 可 以 不 需要 hibernate.cfg.xml 文件 。 

编辑 ROOT\WEB-INF 目录 下 的 applicationContextxml， 配 置 Hibermate 的 相关 信息 。 配 置 
代码 如 下 。 


<?xml version="1.0" encoding="UTF-8"?> 
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<!-- - Application context definition for "springapp" DispatcherServlet. --> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-2.5.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx-2.5.xsd"> 
<context:property-placeholder location="classpath:jdbc.properties" /> 
<bean id="datasource" 
class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close"> 
<property name="driverClassName" value="${jdbc.driverCclassName}" /> 
<property name="url" value="${jdbc.url}" /> 
<property name="username" value="${jdbc.username}" /> 
<property name="password" value="${jdbc.password}" /> 
</bean> 
<!-- Hibernate SessionFactory --> 
<bean id="sessionFactory" 
class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> 
<property name="dataSource" ref="datasource"/> 
<property name="configLocations" 
value="classpath:/hibernate.cfg.xml"></property> 
</bean> 
<!-- Transaction manager for a single JDBC DataSource --> 
<bean id="transactionManager" 


class="org.springframework.orm.hibernate3.HibernateTransactionManager"> 
<property name="sessionFactory" ref="sessionFactory" /> 
</bean> 
<tx:annotation-driven transaction-manager="transactionManager" /> 


<bean id="hibernateTemplate" 
class="org.springframework.orm.hibernate3.HibernateTemplate"> 
<property name="sessionFactory" ref="sessionFactory" /> 
</bean> 


<!-- 各 个 模块 Bean 声明 的 导入 --> 


<import resource="classpath:/beans/Main.xml"/> 
<import resource="classpath:/beans/Emp.xml"/> 
<import resource="classpath:/beans/Admin.xml"/> 
<import resource="classpath:/beans/Recruit.xml"/> 
<import resource="classpath:/beans/Incentives.xml"/> 
<import resource="classpath:/beans/Train.xml"/> 
<import resource="classpath:/beans/Pay.xml"/> 
</beans> 
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15.4 


系统 的 实现 


对 于 企业 来 说 ， 一 个 人 力 资源 管理 系统 ， 其 简洁 明了 的 页 面 风格 和 严谨 的 逻辑 结构 是 必 不 


可 少 的 。 


由 于 此 项 目 功能 的 实现 太 多 ， 我 不 再 一 一 介绍 ， 读 者 可 以 根据 本 章 源码 来 做 具体 的 分 析 ， 


这 里 只 讲解 典型 的 模块 功能 的 实现 。 


首先 ， 系统 进入 主 界面 ,可 以 看 到 人 力 资源 管理 系统 主要 包括 基本 信息 管理 和 系统 管理 两 
大 模块 ， 其 中 基本 信息 管理 模块 包括 员工 信息 管理 、 应 聘 信 息 管理 、 奖 惩 信息 管理 、 培 训 信息 
管理 和 薪资 信息 管理 五 大 管理 模块 ， 系 统管 理 模块 中 有 管理 员 信息 管理 模块 ， 分 别 点 击 相应 的 


标题 可 以 进入 各 部 分 界面 ， 如 图 15-3 所 示 。 


Wl 


15-3 ”人 力 资源 管理 系统 主 界面 


15.4.1 管理 员 模 块 一 一 代码 开发 步骤 


管理 员 模 块 主要 包括 管理 员 列 表 、 添加 管理 员 、 修改 管理 员 和 删除 管理 员 四 部 分 。 单 各 


事 


理 员 信 息 管 理 ” 和 “管理 员 列表 ”按钮 可 以 看 到 管理 


E 员 信息 的 表单 ， 如 图 15-4 所 示 。 


15-4 ”管理 员 信 息 表单 
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以 上 所 看 到 的 浏览 信息 的 分 页 显示 ， 在 整个 项 目 中 都 要 用 到 ， 在 这 一 节 里 将 详细 地 讲解 一 
个 功能 模块 的 具体 实现 方法 ， 读 者 可 以 模仿 以 下 模块 自己 动手 实现 。 以 下 是 具体 的 实现 步骤 。 

(1) 在 项 目 中 新 建 com.pmangerpo 包 , 在 该 包 下 用 hibemate 的 数据 库 反 向 工程 生成 admin 
实体 类 和 该 类 的 实体 类 上 映射。 首先 在 MyEclipse 里 的 右上 角 打 开 MyEclipse database Explorer 
界面 ， 新 建 一 个 与 MySQL 数据 库 的 链接 ， 然 后 找到 admin 表 ， 右 键 单 击 Hibernate Reverse 
Engineering 反 向 工程 生成 admin 实体 类 和 实体 类 上 映射。 代码 如 下 所 示 。 

admin 实体 类 代码 : 


package com.pmanager.po; 
/六 六 
* Rdmin entity. Q@author MyEclipse Persistence Tools 
全 
public class Rdmin implements java.io.Serializable { 
Do 
private Integer id; 
private String adminname; 
private String password; 
// Constructors 
/** default constructor */ 
public Admin() { 
} 
/** minimal constructor */ 
public Admin(Integer id) { 
this.id = id; 
} 
/ee Foll constructor */ 
public Admin(Integer id, String adminname, String password) { 
this.id = id; 
this.adminname = adminname; 
this.password = password; 
} 
// Property accessors 
public Integer getId() { 
return this.id; 


public void setId(Integer id) { 
this-dd = SG 

} 

public String getAdminname() { 
return this.adminname; 

} 

public void setAdminname (String adminname) { 
this.adminname = adminname; 

} 

public String getPassword() { 


return this.password; 
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public void setPassword(String password) { 


this.password = password; 


; 
下 面 是 随 反 向 工程 一 起 生成 的 admin 的 实体 类 映射 文件 Admin.hbm.xml。 
admin 映射 文件 代码 : 


<?xml Version="1.0"” encoding="utf-8"?> 
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 
3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 
"引导 = 
Mapping file autogenerated by MyEclipse Persistence Tools 
一 -> 
<hibernate-mapping> 
<class name="com.pmanager.po.Admin" table="admin" catalog="pmanager"> 
<id name="id" type="java.lang.Integer"> 
<column name="id" /> 
<generator class="assigned" /> 
</id> 


<property name="adminname" type="java.lang.string"> 
"adminname" length="30"> 
<comment> 管 理 员 </comment> 
</column> 
</property> 
<property name="password" type="java.lang.string"> 
<column name="password" length="50"> 
<comment> 密 码 </comment> 
</column> 


<column name= 


</property> 
</class> 
</hibernate-mapping> 


(2) 创建 DAO 层 架构 。 在 项 目 中 新 建 com.pmanager.dao， 该 包 下 存放 持久 层 的 所 有 接口 ， 


在 该 包 下 新 建 AdminDao 接口 ， 负 责 与 持久 化 对 象 交互 , 封装 了 数据 的 增 、 删 、 改 、 查 等 操作 ， 


容 如 下 。 
package com.pmanager.dao; 
import com.pmanager.exception.ModelException; 
import com.pmanager.po.Admin; 
import com.zzu.util.PageList; 


public interface AdminDao { 
/二 二 
* 加 载 管 理 员 信息 列表 ( 按 admin 参数 进行 模糊 匹配 ) 
* @param admin 模糊 匹配 对 象 
* @return 管理 员 列表 
* ethrows ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
wh 
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public PageList<Admin> list(Admin admin,int skip,int size) throws 
ModelException; 
/** 
* 添加 管理 员 信 息 
* @param admin 管理 员 信息 
* @return 管理 员 信息 
* @throws ModelException 任何 可 能 的 业务 逻辑 异常 , 异常 包含 异常 消息 和 错误 代码 
Ge 
public Admin add(Admin admin) throws ModelException; 
/** 
* 加 载 管理 员 信 息 
* @param id 加 载 管 理 员 信息 
* @return id 
* @throws ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
大 
六 
public Admin load(int id) throws ModelException; 
/** 
* 修改 管理 员 信 息 
* @param admin 管理 员 信 息 
* @throws ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
大 
- 
public void modify(Admin admin) throws ModelException; 
有 


(3) 创建 DAO 层 实现 类 。 在 项 目 中 的 com.pmanager.dao 包 中 ， 新 建 AdminDao 接口 的 实 
现 类 AdminDaoImpl， 实 现 接口 中 的 方法 ， 内 容 如 下 。 


package com.pmanager .dao7 


import java.sql.SsQLException; 
import org.hibernate.Criteria; 
import org.hibernate.HibernateException; 
import org.hibernate.Session; 
import org.hibernate.criterion.MatchMode; 
import org.hibernate.criterion.Order; 
import org.hibernate.criterion.Projections; 
import org.hibernate.criterion.Restrictions; 
import org.springframework.orm.hibernate3.HibernateCallback; 
import org.springframework.orm.hibernate3.support.HibernateDaoSupport; 
import com.pmanager.exception.ModelException; 
import com.pmanager.po.Admin; 
import com.zzu.util.PageList; 
public class AdminDaoImpl extends HibernateDaoSupport implements AdminDao { 
@suppressWarnings ("unchecked") 
public PageList<Admin> list(final Admin admin, final int skip,final int 
size) 
throws ModelException { 
tryt{ 
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PageList<Admin> list = (PageList<Admin>) 
this.getHibernateTemplate() .execute (new HibernateCallback(){ 


public Object doInHibernate (Session session)// 获 取 session 对 象 

throws HibernateException, SQLException { 

Criteria query = session.createCriterial(Admin.class); 

// 查 询 admin 表 

// 组 合 条 件 

if(admin.getAdminname () !=null){ 
query.add (Restrictions.like ("adminname", 

admin.getRdminname (), MatchMode .ANYWHERE) ) 7 
} 


// 统 计 行 数 

query.setProjection (Projections.rowCount ()); 
Long count = (Long) query.uniqueResult (); 
// 查 询 结 果 


query.setProjection (null); 
query.addorder (Order.asc ("id")); 
query.setFirstResult (skip); 
query.setMaxResults (size); 
PageList<Admin> list = new PageList(count.intValue()); 
list.addAll (query.1ist()); 
return list; 
11); 
return list; 
}catch (Exception e){ 
e.printstackTrace () 7 
throw new ModelException(l,e.getMessage()); 
} 
} 
public Admin add(Admin admin) throws ModelException { 
Eryt 
this.getHibernateTemplate() .save (admin); 
this.getHibernateTemplate() .flush(); 


return admin; 
}catch (Exception e){ 
e.printstackTrace () 7 
throw new ModelException(l,e.getMessage()); 
} 
n 
public Admin load(int id) throws ModelException { 


try{ 
return (Admin) this.getHibernateTemplate() .get (Admin.class, id); 
}catch (Exception e){ 
e.printstackTrace (); 
throw new ModelException(l,e.getMessage()); 


| 
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} 
public void modify (Admin admin) throws ModelException { 
Admin adm = (Admin) this.getHibernateTemplate() .get (Admin.class, 
admin.getId()); 
try{ 
adm.setAdminname (admin .getAdminname ()); 
adm.setPassword (admin.getPassword()); 
this.getHibernateTemplate() .saveOrUpdate (adm); 
}catch (Exception e){ 
e.printstackTrace () 7 
throw new ModelException(l,e.getMessage()); 


} 


| 
(4) 创建 业务 层 接口 。 在 项 目 中 新 建 com.pmanager.service 包 , 在 该 报 下 新 建 AdminService 
接口 ， 编 写 需 要 实现 的 方法 ， 代 码 如 下 。 


public interface RdminService { 


/太太 


+ 


加 载 管 理 员 信息 列表 ( 按 admin 参数 进行 模糊 匹配 ) 
* @param admin 模糊 匹配 对 象 
ereturn 管理 员 列表 
* @throws ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
人 
public PageList<Admin> list(Admin admin,int skip,int size) throws 
ModelException; 
/*# 
* 添加 管理 员 信 息 
* @param admin 管理 员 信息 
* Q@return 管理 员 信息 
* Q@throws ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
过 
public Rdmin add (Rdmin admin) throws ModelException; 
/*# 
* 加 载 管理 员 信息 
* eparam id 加 载 管理 员 信息 
* @return id 
* @throws ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
友人 
public Admin load(int id) throws ModelException; 
/*# 
* 修改 管理 员 信息 
* @param admin 管理 员 信息 
* @throws ModelException 任何 可 能 的 业务 逻辑 异常 ,异常 包含 异常 消息 和 错误 代码 
public void modify (Admin admin) throws ModelException; 
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(5) 编写 业务 层 实现 类 AdminServiceImpl， 实 现 上 面 接口 中 的 4 个 方法 ， 代 码 如 下 。 


public class AdminServiceImpl implements AdminService { 
private AdminDao adminDao = null;// 该 模块 对 应 的 DAO 


public void setAdminDao (AdminDao adminDao) {// 设 置 到 的 set 方法 
this.adminDao = adminDao; 

} 

// 添 加 信息 

public Admin add(Admin admin) throws ModelException { 
int s = 10000000; 
int sid = (int) (System.currentTimeMillis()%1000000); 
admin.setId(new Integer(s+sid)); 
adminDao.add (admin); 
return null; 

// 浏 览 信息 

public PageList<Admin> list(Admin admin, int skip, int size) 

throws ModelException { 


return adminDao.list (admin, skip, size); 
3 
// 加 载 信息 


public Admin load(int id) throws ModelException { 


return adminDao.1load(id); 
3» 
// 修 改 信息 


public void modify(Admin admin) throws ModelException { 


adminDao.modify(admin); 


// 过 滤 查 询 分 页 功能 
private int rows = 10; 
private int page = 1; 


private Admin like = new Admin(); 
public Admin getLike() { 
return like; 


public void setLike (Admin like) { 
this.like = like; 


public void setRows(int rows) { 


this.rows = rows; 
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public void setPage (int page) { 
this.page = page; 


public void list() { 

try { 
JSONObject root = new JSONObject(); 
PageList<Admin> list = adminService.list(like, (page - 1) * rows, 

rows); 
int count = list.getRows(); 
root.put ("page", page); 
rTOOEput (tl Eolalr Count /Lows 1 ((count % LOWws) > 0 2 1 2 0) 
root.put ("records", count); 
JSONArray rows = new JSONRrray() 7 
for (Admin SS = 1ist) { 
rows.add(s, JsonUtil.config()); 

} 


root.put ("rows", rows); 


ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
root.write (ServletActionContext .getResponse() .getWwriter()); 
} catch (Throwable e) { 
e.printstackTrace () 7 


} 


(6) 编写 action 类 。 在 项 目 中 新 建 com.pmanager.action 包 ， 在 该 包 中 新 建 admin 的 action 
类 AdminManager， 继承 自 com.opensymphony.xwork2.ActionSupport 类 , 在 这 里 编写 分 页 显示 。 
代码 如 下 。 


@suppressWarnings ("serial") 
public class AdminManager extends Actionsupport { 


private RdminService adminService = null;// 注 入 service 
private Admin admin = null;// 注 入 admin 
// 实 现 Get 和 Set 方法 
public Admin getAdmin() { 
return admin; 


public void setAdmin (Rdmin admin) { 
this.admin = admin; 


public void setAdminService (AdminService adminService) { 
this.adminService = adminService; 
} 
/** 
* 显示 员工 主 界面 
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* Ereturhn success 

i 

public String main(){ 
return "success"; 


} 


// 过 滤 查 询 功能 及 分 页 显示 功能 

private int rows = 10; 每 页 的 行 数 

private int page = 1; 页 数 

private Admin like = new Admin() ;前台 用 于 使 用 的 1ike 字段 
public Admin getLike() { 


return like; 


public void setLike (Rdamin like) { 


this.like = like; 


public void setRows (int 
this.rows = rows; 


public void setPage (int 
this.page = page; 
} 
// 用 于 处 理 分 页 的 方法 
public void list() { 
try { 
JSONObject root 
PageList<Admin> 
rows); 


rows) { 


page) { 


= new JSONObject (); 


list = adminService.list(like, (page - 1) * rows, 


int count = list.getRows(); 


root.put ("page", 
root-put("total® 


page); 
7 Count / rows + ((count % rows) > 0 


root.put ("records", count); 


JSONArray rows = 
for (Admin s : 1 

rows.addl(s, 
} 


root.put ("rows", 


ServletActionContext .getResponse () .setCharacterEncoding ("utf-8"); 
root.write(ServletActionContext .getResponse() .getWriter ()); 


} catch (Throwable e 


e.printstackTrac 


} 
// 添 加 admin 信息 


new JSONArray (); 
st 
JsonUtil.config()); 


rows); 


1 
e(); 


public String add() throws ModelException { 
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adminservice.add (admin); 
return "success"; 
} 
// 修 改 admin 信息 
public String modify() { 
try ut 
adminService.modify(admin); 
return "success"; 
} catch (ModelException e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 


TtEUrOYETTOT 


// 加 载 admin 信息 


private int id; 


public void setId(int id) { 
this.id = id; 
} 
public void load() { 
Cry t 
JSONObject root = new JSONObject (); 
Admin adm = adminService.load(id); 
root.element ("admin", adm, JsonUtil.config()); 


ServletActionContext .getResponse () .setCharacterEncoding ("utf-8"); 
root.write(ServletActionContext .getResponse() .getWriter ()); 
} catch (Throwable e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 


} 


(7) 创建 admin 的 action 映射 文件 。 在 项 目 中 新 建文 件 夹 action， 在 该 文件 夹 下 新 建 
AdminManager.xml 的 配置 文件 ， 主 要 在 配置 admin 的 action 类 ， 代 码 如 下 。 


<struts> 
<package name="AdminManager" extends="default" namespace="/admin"> 
<action name="main" class="adminManager" method="main"> 
<result name="success">/WEB-INF/jsp/Admin/main.jsp</result> 
</action> 
<action name="list" class="adminManager" method="list"/> 
<action name="add" class="adminManager" method="add"> 


<result name="success" type="redirect">main</result> 
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</action> 

<action name="modify" class="adminManager" method="modify"> 
<result name="success" type="redirect">main</result> 

</action> 


<action name="load" class="adminManager" method="load" /> 


</package> 
</struts> 


以 上 文件 配置 好 后 ， 把 该 文件 再 在 struts.xml 中 进行 配置 ， 以 后 这 种 各 个 模块 的 action 配 
置 文件 ， 都 要 在 struts.xml 中 进行 配置 。 代 码 如 下 。 


</package> 
<include file="action/Main.xml"/> 
<package> 
(8) 创建 admin 的 spring 映射 文件 。 在 项 目 中 新 建 bean 文件 夹 ， 在 该 文件 夹 中 新 建 
Admin.xml， 再 改 文件 中 配置 需要 用 Spring 进行 管理 的 dao 组 件 ，service 组 件 和 action 组 件 。 
代码 如 下 。 
下 天 全 二 六 


<bean id="adminDao" class="com.pmanager.dao.AdminDaoImpl"> 
<property name="hibernateTemplate" ref="hibernateTemplate" /> 


</bean> 

l= Sryiceas => 

<bean id="adminService" class="com.pmanager.service.AdminServiceImpl"> 
<property name="adminDao" ref="adminDao" /> 


</bean> 
<!-- Actions --> 
<bean id="adminManager" class="com.pmanager.action.AdminManager" 
scope="prototype"> 
<property name="adminService" ref="adminService"></property> 
</bean> 
</beans> 


配置 完 后 还 要 在 spring.xml 中 进行 配置 ， 以 后 各 个 模块 配置 都 要 在 spring.xml 文件 中 进行 
配置 。 代 码 如 下 。 
<!-- 各 个 模块 Bean 声明 的 导入 --> 
<import resource="classpath:/beans/Admin.xml"/> 
<import resource="classpath:/beans/Main.xml"/> 


<import resource="classpath:/beans/Emp .xml"/> 
</bean> 


(9) 前 台 页 面 的 编写 。 在 项 目 中 的 WEB-INFO 文件 下 新 建 名 为 jsp 的 文件 ,在 该 文件 中 新 
建 Admin 文件 ， 在 该 文件 中 新 建 mainjsp， 用 于 分 页 显示 数据 的 代码 、 过 滤 查 询 和 修改 的 代 
码 如 下 。 
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<body> 
<div id="tabs"> 
<ul> 
<1i><a href="#tab-1"> 管 理 员 列 表 </a></1i> 
<li><a hre #tab-2"> 添 加 管理 员 </a></1i> 
<1i><a href="#tab-3"> 修 改 管理 员 </a></1i> 
</ul> 


<div id="tab-1"> 


<table id="grid" class="table" width="100%" cellspacing=0 cellpadding=0> 
</table> 
<div id="page"></div> 
</div> 
<div id="tab-2"> 
<form action="add" method="post" id="add form"> 
<s:hidden name="admin.id"/> 
<table class="table" width="100%" cellspacing=0 cellpadding=0> 
<tr class="tr"> 
<th class="th" colspan="4" align="left"> 管理 员 信 息 </th> 
</tr> 
<tr class="tr"> 
<td class="td"> 用 户 名 :</td><td class="td"><s:textfield 
name="admin.adminname" /></td> 
<td class="td"> 密 码 :</td><td class="td"><s:textfield 
name="admin.password" /></td> 


</tr> 
<tr class="tr"> 
<td class="td" style="height:90px;" colspan="4" 
align="center"><button id="add_save"> 保 存 </button><button id="add_reset"> 重 置 
</button></td> 
</tr> 
</table> 
</form> 
</div> 
<div id="tab-3"> 
<form action="modify" method="post" id="mod form"> 
<s:hidden name="admin.id" id="adminid"/> 
<table class="table" width="100%" cellspacing=0 cellpadding=0> 
<tr class="tr"> 
<th class="th" colspan="4" align="left"> 管理 员 信 息 </th> 
</tr> 
<tr class="tr"> 
<td class="td"> 用 户 名 :</td><td class="td"><s:textfield 
id="adminadminname" name="admin.adminname" /></td> 


<td class="td"> 密 码 :</td><td class="td"><s:textfield 
id="adminpassword" name="admin.password" /></td> 
SEE 


<tr class="tr"> 
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<td class="td" style="height:90px;" colspan="4" 
align="center"><button id="mod_ save"> 保 存 </button><button id="mod reset"> 重 置 
</button></td> 
< 
</table> 
</form> 
</div> 
</div> 
<script type="text/javascript"> 
$ (function(){ 
$('#tabs') .height ($ (window) .height ()-10); 
$('#tabs').tabs(); 
$('#tabs') .tabs('disable',2) 
$('button') .button(); 


init table(); 
init add(); 
init mod(); 


j 
function init add(){ 
$('#add save') .click(function(){ 
$('#add form') .submit() 7 
return false; 
1); 
$('#add reset').click(function(){ 
$('#tabs') .tabs( "select" , 0); 
return false; 
1); 
} 
function init mod(){ 
$('#mod save') .click(function(){ 
$('#mod form') .submit () 7 
return false; 
1D); 
$('#mod reset') .click(function(){ 
$('#tabs') .tabs ("select",0); 
$('#tabs') .tabs('disable',2); 
return false; 
1); 
} 
function init table()f{ 
$("#grid") .jqGrid({ 
刘 正 下 局 下 主 如 在 < 记 
datatype 5 可 OP 
colModel:[ 
{name:'like.id',jsonmap:"id",]label: ' 编 号 ' ,width: 40,align:"left"}, 
{name: 'like.adminname',jsonmap:"adminname",1label:" 用 户 名 
"Width:60,align:"left"}, 
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{name:'like.password',jsonmap:"password",1label:' 密 码 
"widthsli5raligan "left"}y 
I 
scroll: true, 
pager: '#page', 
Viewrecords: true, 
caption: "管理 员 查 询 结 果 "， 
width: $ (window) .width()-40, 
height: $ (window) .height()-170, 
forceFit : true, 
multiselect:true, 
jsonReader:{ 
repeatitems : false 


}, 
ondblClickRow:function(id,row,col,e){ 


load(id,function(){ 
$('#tabs') .tabs('enable',2); 
$('#tabs') .tabs ("select",2); 
DD); 
} 
1); 
$('#grid') .navGrid('#page', { 
add:false, 
edit:false, 
search:false, 
delfunc:function(ids){ 
remove (ids); 


Mn 
$('#grid') .filterToolbar (); 


} 
function remove(id)t{ 
alert (id); 
} 
function loadl(id,callback){ 
$.getJSON('lo0ad', {id:id},function(data, status,xhr){ 
var admin = data.admin; 
forl(var v in admin){ 
alert (admin[v]); 
try{$ ('#admin'+v) .val (admin[v]);}catch(e) {alert (e);} 
} 
callback(); 
Ss 
</script> 
</body> 
</html> 


< 
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至 此 ， 管 理 员 管理 模块 就 完成 了 ， 下 面 来 看 看 效果 。 单 击 “ 管 理 员 信 息 管理 ”按钮 ， 出 现 
如 图 15-5 所 示 的 页 面 。 


15-5 ”管理 员 信 息 管理 


单 击 “ 添 加 管理 员 ” 按 钮 ， 系 统 自动 进入 如 图 15-6 所 示 的 界面 。 通 过 该 界面 可 以 添加 管 
理 员 信息 ， 包 括 管理 员 的 用 户 名 和 密码 ， 如 图 15-6 所 示 。 

在 本 系统 中 ， 按 如 图 15-5 所 示 ， 双 击 要 修改 的 管理 员 信息 所 在 的 行 ， 可 以 进入 修改 管理 
员 界 面 。 通 过 该 界面 可 以 对 所 选中 的 管理 员 的 信息 进行 修改 ， 如 图 15-7 所 示 。 


Ey ey us on 
图 15-6 添加 管理 员 图 15-7 修改 管理 员 


在 管理 员 列表 中 ， 通 过 配色 选 要 删除 的 管理 员 信息 列 ， 然 后 单 击 国 按 钮 ， 系 统 会 提示 要 删 
除 的 管理 员 信 息 列 ， 如 图 15-8 所 示 。 


[ETT EE JJ 。 


15-8 删除 管理 员 信息 
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15.4.2 ”员工 管理 模块 一 一 jQuery 框架 的 使 用 


前 一 小 节 ， 讲 解 了 横 块 后 台 处 理 程序 的 实现 过 程 。 在 这 一 节 里 ， 将 介绍 前 台 友好 界面 的 具 
体 实 现 过 程 ， 在 此 将 用 到 一 个 优秀 的 JavaScript 框架 一 一 jQuery。 

首先 ， 先 浏览 下 员工 管理 模块 的 前 台 展 示 效 果 ， 员 工 管理 模块 主要 包括 员工 列表 、 添 加 员 
工 、 修 改 员工 和 删除 员工 四 部 分 。 单 击 “ 员 工 信 息 管 理 ” 和 “员工 列表 ”按钮 可 以 看 到 员工 信 
息 的 表单 ， 如 图 15-9 所 示 。 
[总 人 | 
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如 图 15-9 所 示 ， 按 钮 的 效果 及 左 侧 栏 中 的 菜单 栏 中 的 下 拉 框 的 效果 都 是 通过 jQuery 来 实 
现 的 ， 下 面 来 简单 地 介绍 一 下 其 实现 过 程 。 

(1) 在 jsp 页 面 中 导入 jQuery 包 ， 这 里 要 用 到 四 个 包 : jquery-1.4.2.min.js、jquery-ui-1.8.5. 
min.js、grid.locale-cn.js、jquery.jqgrid.min.js。 在 页 面 中 使 用 这 些 包 的 方法 代码 如 下 。 


<script type="text/javascript" 
src="../scripts/jquery-1.4.2.min.js"></script> 

<script type="text/javascript" 
src="../scripts/jquery-ui-1.8.5.min.js"></script> 

<script type="text/javascript" src="../scripts/il8n/grid.locale-cn.js" 
charset="utf-16"></script> 

<script type="text/javascript" src="../scripts/jquery.jqgrid.min.js" 
charset="utf-8"></script> 


(2) 页 面 展 示 效果 的 实现 。 页 面 的 部 分 代码 如 下 。 


<body> 
<div id="tabs"> 
<ul> 
<li><a href="#tab-1"> 管 理 员 列表 </a></1i> 
<1i><a href="#tab-2"> 添 加 管理 员 </a></1i> 
<1i><a href="#tab-3"> 修 改 管理 员 </a></1i> 
</ul> 
<div id="tab-1"> 
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<table id="grid" class="table" width="100%" cellspacing=0 
cellpadding=0> 
</table> 
<div id="page"></div> 
</div> 
<div id="tab-2"> 
<form action="add" method="post" id="add form"> 
<s:hidden name="admin.id"/> 
<table class="table" width="100%" cellspacing=0 cellpadding=0> 
<tr class="tr"> 
<th class="th" colspan="4" align="left"> 管理 员 信 息 </th> 
</tr> 
<tr class="tr"> 
<td class="td"> 用 户 名 :</td><td class="td"><s:textfield 
name="admin.adminname" /></td> 
<td class="td"> 密 码 :</td><td class="td"><s:textfield 
name="admin.password" /></td> 


</tr> 
<tr class="tr"> 
<td class="td" style="height:90px;" colspan="4" 
align="center"><button id="add_save"> 保 存 </button><button id="add_reset"> 重 置 
</button></td> 
</ErS 
</table> 
</form> 
</div> 
<div id="tab-3"> 
<form action="modify" method="post" id="mod form"> 
<s:hidden name="admin.id" id="adminid"/> 
<table class="table" width="100%" cellspacing=0 cellpadding=0> 
<tr class="tr"> 
<th class="th" colspan="4" align="left"> 管理 员 信息 </th> 
</tr> 
<tr class="tr"> 
<td class="td"> 用 户 名 :</td><td class="td"><s:textfield 
id="adminadminname" name="admin.adminname" /></td> 


<td class="td"> 密 码 :</td><td class="td"><s:textfield 
id="adminpassword" name="admin.password" /></td> 
</tr> 


<tr class="tr"> 
<td class="td" style="height:90px;" colspan="4" 

align="center"><button id="mod_save"> 保 存 </button><button id="mod reset"> 重 
置 </button></td> 

</tr> 

</table> 

</form> 

</div> 
</div> 
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根据 以 上 代码 , 给 id 为 tab-l 的 div 中 的 table 定义 id 为 grid, 通过 后 台 程 序 处 理 得 到 的 数 
据 以 json 数据 形式 向 前 台 输 入 ， 然 后 将 对 应 的 init_table 函数 在 初始 化 函数 中 初始 化 。 其 部 分 
代码 如 下 。 


function init _ table(){ 
$("#grid") .jaqGrid({ 
Ue LB 
datatype : "json", 
colModel:[ 
{name:'like.id',jsonmap:"id",1label:' 编 号 ' ,width:40,align:"left"}, 
{name:'like.adminname',jsonmap:"adminname",1label:' 用 户 名 
,width:60,align:"left"}, 
{name:'like.password',jsonmap:"password",1label:' 密 码 
WidtheliSralign: "Left yy 


], 

scroll: true, 

pager: '#page', 

Viewrecords: true, 
caption: "管理 员 查 询 结 果 "， 
width: $ (window) .width()-40， 
height: $ (window) .height()-170, 
forceFit : true, 
multiselect:true, 
jsonReader:1{ 

repeatitems : false 
] 
ondblClickRow:function(id,row,col,e){ 


load(id,function(){ 
$('#tabs') .tabs('enable',2); 
$('#tabs') .tabs ("select",2); 
下 
} 
DD); 
$('#grid') .navGrid('#page',{ 
add:false, 
edit:false, 
search:false, 
delfunc:function(ids){ 
remove (ids); 


]) 
$('#grid') .filterToolbar (); 


} 
项 目 运 行 时 ， 前 台 向 后 台 传 递 action 请 求 ，Struts 2 根据 请 求 找到 与 请 求 相应 的 action， 通 
过 action 与 业务 逻辑 的 交互 ,再 把 请 求 响 应 传 到 页 面 , 因此 我 们 就 看 到 了 以 上 页 面 .其 中 的 action 
也 是 继承 了 com.opensymphony.xwork2.ActionSupport 类 ， 代 码 如 下 。 
< 
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public class EmpManager extends ActionSupport { 


private EmpService empService = null; 
private Employee employee = null; 
private String birthday; 
public Employee getEmployee() { 
return employee; 
} 
public void setEmployee (Employee employee) { 
this.employee = employee; 
} 
public void setEmpService (EmpService empService) 
this.empService = empService; 
} 
public void setBirthday(String birthday) { 
this.birthday = birthday; 
} 


/六 

* 显示 员工 主 界面 

* @return success 
i 


public String main(){ 


return "Success 


} 

// 过 滤 查 询 功能 

private int rows = 10; 
private int page = 1; 


private Employee like = new Employee(); 
private Short id; 
public void setId(Short id) { 
this.id = id; 
} 
public Employee getLike() { 
return like; 
} 
public void setLike (Employee like) { 
thisi1ike = 11key 
} 
public void setRows(int rows) { 
this.rows = rows; 
} 
public void setPage(int page) { 
this.page = page; 
| 
public void list() { 
1 
JSONObject Foot = new JSONObJject () 


PageList<Employee> list = empservice.1ist (like, 


rows); 


(page — 1) * rows, 
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int count = list.getRows(); 
root.put ("page", page); 
TOOtepUt( totals cont yy ONSs tO (NCOUnt S cow > 0 1 = ON 
root.put ("records", count); 
JSONArray rows = new JSONArray(); 
for (Employee s : list) { 
rows.add(s, JsonUtil.config()); 
} 


root.put ("rows", rows); 


ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
root.write(ServletActionContext .getResponse() .getWriter ()); 
} catch (Throwable e) { 
e.printstackTrace () 7 


} 
public String add() throws ModelException { 


empService.add (employee); 
return "success"; 

} 

public String modify() { 
try { 


empService.modify (employee); 
Peturn "success"s 
} catch (ModelException e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 
return "error"; 
} 
public void load() { 
Tr 
JSONObject root = new JSONObject(); 
Employee emp = empService.load(id); 
root.element ("employee", emp, JsonUtil.config()); 


ServletActionContext .getResponse () .setCharacterEncoding ("utf-8"); 
Toot .write(ServletActionContext .getResponse () .getWriter () ) 7 
} catch (Throwable e) { 
// TODO Auto-generated catch block 
e.printstackTrace (); 


} 
单 击 “添加 员工 ”按钮 ， 系 统 自动 进入 如 图 15-10 所 示 的 界面 。 通 过 该 界面 可 以 添加 员工 
信息 ， 包 括 员工 的 姓名 、 密 码 、 性 别 、 生 日 、 地 址 、 电 话 和 简介 ， 如 图 15-10 所 示 。 


< 


BIG 


图 15-10 添加 员工 


当 填 写 完 要 输入 的 信息 后 ， 单 击 “ 提 交 ” 按 钮 ， 根 据 前 台 JavaScript 的 init_add 函数 为 按 
钮 附加 一 个 jQuery 事件 ， 然 后 调用 相应 的 action 中 的 add 方法 进行 处 理 添加 信息 ， 代 码 如 下 。 


function init add(){ 
$('#add save') .click(function(){ 
$('#add form') .submit () 7 
return false; 
由 
$('#add reset').click(function(){ 
$('#tabs') .tabs( "select" , 0); 
return false; 
1); 
上 


在 本 系统 中 ， 按 如 图 15-9 所 示 ， 双 击 要 修改 的 员工 信息 所 在 的 行 ， 可 以 进入 修改 员工 界 
面 。 通 过 该 界面 可 以 对 所 选中 的 员工 的 信息 进行 修改 ， 包 括 员工 的 姓名 、 密 码 、 性 别 、 生 日 、 
地 址 、 电 话 和 简介 ， 如 图 15-11 所 示 。 
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15-11 修改 员工 


填写 完 要 修改 的 信息 后 ， 根 据 前 台 main 页 面 的 JavaScript 的 init_mod0 方 法 ， 为 “提交 ” 
按钮 附加 事件 ， 然 后 跳 转 到 后 action 进行 处 理 。 代 码 如 下 。 


function init mod(){ 
$('#mod save') .click(function(){ 
$('#mod form') .submit () 7 
return false; 


D); 
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$('#mod reset') .click(function(){ 
$('#tabs') .tabs ("select",0); 
$('#tabs') .tabs('disable',2); 
return false; 
Ds; 
1 


在 员工 列表 中 ， 通 过 醒 勾 选 要 删除 的 员工 信息 列 ， 然 后 单 击 国 按钮 ， 系 统 会 提示 要 删除 的 
员工 信息 列 ， 如 图 15-12 所 示 。 


15-12 ”删除 员工 信息 


通过 以 上 过 程 我 们 了 解 了 这 个 项 目 中 的 整体 模块 的 开发 步骤 ， 也 看 到 了 使 用 jQuery 框架 
所 展示 的 前 台 的 效果 。 以 下 章节 可 以 在 前 两 小 节 介绍 的 基础 上 进行 逐一 开发 ， 下 面 在 这 里 简单 
的 介绍 下 剩余 模块 的 功能 和 简单 实现 方式 。 


15.4.3 ”应 聘 管理 模块 


应 聘 管理 模块 主要 包括 应 聘 者 列表 、 添加 应 聘 者 、 修改 应 聘 者 和 删除 应 聘 四 部 分 。 单 击 “ 应 
聘 信息 管理 ”和 “应 聘 者 列表 ”按钮 可 以 看 到 应 聘 者 信息 的 表单 ， 如 图 15-13 所 示 。 


图 15-13 应聘 者 信息 管理 


以 上 列表 的 显示 ， 前 台 向 后 台 传递 了 action 请 求 ，Struts 2 根据 请 求 找到 与 请 求 相应 的 
action， 通 过 action 与 业务 罗 辑 的 交互 ， 再 把 请 求 响应 传 到 页 面 ， 因 此 就 看 到 了 以 上 页 面 。 其 
中 的 action 也 是 继承 了 com.opensymphony.xwork2.ActionSupport 类 ， 代 码 如 下 。 


< 
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public class RecruitmentManager extends ActionSupport { 
private RecruitmentService recruitmentService = null; 
private Recruitment recruitment = null; 
public Recruitment getRecruitment() { 
return recruitment; 
} 
public void setRecruitment (Recruitment recruitment) { 
this.recruitment = recruitment; 
} 


public void setRecruitmentService (RecruitmentService recruitmentService) 


this.recruitmentService = recruitmentService; 


/六 
* 显示 员工 主 界面 
-ereturn success 


public String main(){ 
return "success 


} 


// 过 滤 查 询 功能 
private int rows = 10; 
private int page = 1; 


private Recruitment like = new Recruitment (); 
public Recruitment getLike() { 
return like; 
} 
public void setLike (Recruitment like) { 
this.like = like; 
} 
public void setRows (int rows) { 
this.rows = rows; 
} 
public void setPage (int page) { 
this.page = page; 
} 
public void list() { 
try { 
JSONObject root = new JSONObJject () 7 
PageList<Recruitment> list = recruitmentService.list(like, (page 
0 
rows); 
int count = list.getRows(); 
root.put ("page", page); 
roOOCSDUut( "toa count / rous t+ (tcount 3 rowa) > O02 1 ON 
root.put ("records", count); 
JSONArray rows = new JSONArray(); 
for (Recruitment s : list) { 
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rows.add(s, JsonUtil.config()); 


} 


root.put ("rows", rows); 


ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
root .write(ServletActionContext .getResponse() .getWriter ()); 


} catch (Throwable e) { 
e.printstackTrace () 7 


public String add() throws ModelException { 


recruitmentService.add (recruitment) 7 
return "success"; 


} 
public String modify() { 


Ery 4 
recruitmentService.modify(recruitment); 


return “succeas”s 

} catch (ModelException e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 


return "error™; 


// 加 载 


private int id; 


public void setIdl(int id) { 
this.id = id; 

} 

public void load() { 


try { 
JSONObject root = new JSONObJject (); 


Recruitment rec = recruitmentService.1load(id); 
root.element ("recruitment", rec, JsonUtil.config()); 


ServletActionContext .getResponse () .setCharacterEncoding ("utf-8"); 
root .write (ServletRActionContext .getResponse () .getWriter()); 


} catch (Throwable e) { 
// TODO Auto-generated catch block 


e.printstackTrace () 7 


} 
单 击 “ 添 加 应 聘 者 ”按钮 ， 系 统 自 动 进入 如 图 15-14 所 示 的 界面 。 通 过 该 界面 可 以 添加 应 


聘 者 信息 ， 包 括 应 聘 者 的 姓名 、 性 别 、 年 龄 、 职 位 、 专 业 、 工 作 经 验 、 学 历 、 学 校 、 电 话 、 邮 


< 


全， 2 Web 开发 学 习 实录 . 吧 
箱 和 简介 ， 如 图 15-14 所 示 。 


图 15-14 添加 应 聘 者 


当 填 写 完 要 输入 的 信息 后 ， 单 击 “ 提 交 ” 按 钮 ， 根 据 前 台 main 页 面 中 的 JavaScript 的 add 
函数 为 按钮 附加 一 个 jQuery 事件 , 然后 调用 相应 的 action 中 的 add 方法 进行 处 理 添加 信息 , 代 


码 如 下 。 
function init add(){ 
$('#add save').click(function(){ 
$('#add form') .submit (); 
return false; 
Ds 
$('#add reset').click(function(){ 
$('#tabs') .tabs( "select" , 0); 
return false; 
]) 
在 本 系统 中 ， 按 如 图 15-13 所 示 ， 双 击 要 修改 的 应 聘 者 信息 所 在 的 行 ， 可 以 进入 修改 应 聘 
者 界面 。 通 过 该 界面 可 以 对 所 选中 的 应 聘 者 的 信息 进行 修改 , 包括 应 聘 者 的 姓名 、 性 别 、 年龄 、 
职位 、 专 业 、 工 作 经 验 、 学 历 、 学 校 、 电 话 、 邮 箱 和 简介 ， 如 图 15-15 所 示 。 


038208057 


15-15 ”修改 应 聘 者 


在 应 聘 者 列表 中 ， 通 过 可 勾 选 要 删除 的 应 聘 者 信息 列 ， 然 后 单 击 国 按钮 ， 系 统 会 提示 要 删 
除 的 应 聘 者 信息 列 ， 如 图 15-16 所 示 。 
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15-16 ”删除 应 聘 者 


15.4.4 ”奖惩 管理 模块 


奖惩 管理 模块 主要 包括 奖惩 列表 、 添 加 奖惩 、 修 改 奖惩 和 删除 奖惩 四 部 分 。 单 击 “ 奖 惩 信 
息 管理 ”和 “奖惩 列表 ”按钮 可 以 看 到 奖惩 信息 的 表单 ， 如 图 15-17 所 示 。 
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15-17 ”奖惩 信息 管理 


以 上 列表 的 显示 ， 前 台 向 后 台 传 递 了 action 请 求 ，Struts 2 根据 请 求 找到 与 请 求 相应 的 
action， 通 过 action 与 业务 逻辑 的 交互 ， 再 把 请 求 响应 传 到 页 面 ， 我 们 就 看 到 了 以 上 页 面 。 其 
中 的 action 也 是 继承 了 com.opensymphony.xwork2.ActionSupport 类 ， 代 码 如 下 。 


public class IncentivesManager extends ActionSupport { 
private IncentivesService incentivesService = null; 
private Incentives incentives = null; 
public Incentives getIncentives() { 
return incentives; 
| 
public void setIncentives (Incentives incentives) 1{ 
this.incentives = incentives; 
} 


public void setIncentivesService (IncentivesService incentivesService) { 


< 
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this.incentivesService = incentivesService; 


/*# 
* ”显示 员工 主 界面 
* @return success 
public String main(){ 
return “Success"? 
} 
// 过 滤 查 询 功 能 
private int rows = 10; 
private int page = 1; 
private Incentives like = new Incentives(); 


public Incentives getLike() { 
return like; 
} 
public void setLike(Incentives like) { 
this=1ike = Tikes 
} 
public void setRows (int rows) { 
this.rows = rows; 
} 
public void setPage(int page) { 
this.page = page; 
} 
public void list() { 
try { 
JSONObject root = new JSONObject (); 
PageList<Incentives> list = incentivesService.list (like, 
1) * rows, 
rows); 
int count = list.getRows(); 
Foot .put ("page", page); 
Toot=-put("total®r count /rows t KEOUnEC Ss rows) > 0 2 
root.put ("records", count); 
JSONArray rows = new JSONArray (); 
for (Incentives s : list) { 
rows.add(s, JsonUtil.config()); 
root.put ("rows", rows); 
ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
root .write(ServletActionContext .getResponse() .getWriter()); 
} catch (Throwable e) { 


e.printstackTrace () 7 


5 


(page - 


0))7 
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public String add() throws ModelException { 


incentivesService.addl(incentives); 
return "success"; 
} 
public String modify() { 
try 
incentivesService.modify(incentives); 
return "success"; 
} catch (ModelException e) { 
// TODO Auto-generated catch block 
e.printstackTrace (); 


return "error™; 


} 
// 加 载 
private int id; 
public void setId(int id) { 
this.id = id; 
} 
public void load() { 
try { 
JSONObject root = new JSONObJject (); 
Incentives ince = incentivesService.load(id); 
root.element ("incentives", ince, JsonUtil.config()); 
ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
root.write(ServletActionContext .getResponse () .getWriter()); 
} catch (Throwable e) { 
// TODO Auto-generated catch block 
e.printstackTrace (); 


} 


单 击 “ 添 加 奖惩 ”按钮 ， 系 统 自 动 进入 如 图 15-18 所 示 的 界面 。 通 过 该 界面 可 以 添加 奖惩 
信息 ， 包 括 奖 惩 的 奖惩 名 称 、 奖 惩 原 因 和 奖惩 说 明 ， 如 图 15-18 所 示 。 


15-18 ”添加 奖惩 


在 本 系统 中 ， 按 如 图 15-17 所 示 ， 双 击 要 修改 的 奖惩 信息 所 在 的 行 ， 可 以 进入 修改 奖惩 界 
面 。 通 过 该 界面 可 以 对 所 选中 的 奖惩 的 信息 进行 修改 ,包括 奖惩 的 奖惩 名 称 、 奖 惩 原因 和 奖惩 
说 明 ， 如 图 15-19 所 示 。 
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图 15-19 修改 奖惩 


在 奖惩 列表 中 ， 通 过 栈 勾 选 要 删除 的 奖惩 信息 列 ， 然 后 单 击 国 按钮 ， 系 统 会 提示 要 删除 的 
奖惩 信息 列 ， 如 图 15-20 所 示 。 
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15-20 ”删除 奖惩 


15.4.5 ”培训 管理 模块 


培训 理 模块 主要 包括 培训 列表 、 添 加 培训 、 修 改 培训 和 删除 培训 四 部 分 。 单 击 “ 培 训 信息 
管理 ”和 “培训 列表 ”按钮 可 以 看 到 培训 信息 的 表单 ， 如 图 15-21 所 示 。 
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图 15-21 培训 信息 管理 
以 上 列表 的 显示 ， 前 台 向 后 台 传 递 了 action 请 求 ，Struts 2 根据 请 求 找 到 与 请 求 相 应 的 
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action， 通 过 action 与 业务 逻辑 的 交互 ， 青 把 请 求 响应 传 到 页 面 ， 我 们 就 看 到 了 以 上 页 面 。 其 
中 的 action 也 是 继承 了 com.opensymphony.xwork2.ActionSupport 类 ， 代 码 如 下 。 


public class TrainManager extends RARctionSupport { 


private TrainService trainSerVvice = null; 

private Train train = null; 

private String starttime; 

private String stoptime; 

public Train getTrain() { 
return train; 

| public void setTrain (Train train) { 
this.train = train; 

} public void setTrainService (TrainServVice trainService) { 
this.trainService = trainService; 

} 

public String getStarttime() { 
return starttime; 

} 

public void setStarttime (String starttime) { 
this.starttime = starttime; 

} 

public String getStoptime() { 
return stoptime; 

public void setStoptime (String stoptime) { 
this.stoptime = stoptime; 


1/** 

* ”显示 员工 主 界面 

* @return success 
0 


public String main(){ 
return "auccess"s 


| 

// 过 滤 查 询 功能 

private int rows = 10; 
private int page = 1; 


private Train like = new Train() 

public Train getLike() { 
return like; 

} 

public void setLike (Train like) { 
this.1ike = Tikes 

} 

public void setRows (int rows) { 
this.rows = rows; 

| 

public void setPage(int page) { 
this.page = page; 


< 
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public void list() { 

try { 
JSONObject root = new JSONObJject () 7 
PageList<Train> list = trainService.list(like, (page - 1) * rows, 

rows); 
int count = list.getRows(); 
root.put ("page", page); 
ToOOt.pDUt ("total"y count / rowsl + ((count, ® rowa) > 0 2 1 2 OV 
root.put ("records", count); 
JSONArray rows = new JSONArray(); 
EoOr [TnAaln ss ds) 
rows.add(s, JsonUtil.config()); 

} 


root.put ("rows", rows); 


ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
root .write (ServletActionContext .getResponse() .getWwriter()); 
} catch (Throwable e) { 
e.printstackTrace () 7 


} 
public String add() throws ModelException { 


trainSservice.add (train); 


return "success"; 


public String modify() { 
try { 


trainService.modify(train); 
return "successns 
} catch (ModelException e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 


return “error"; 


// 加 载 
private int id; 
public void setId(int id) { 

this.id = id; 
} 
public void load() { 

try { 

JSONObject root = new JSONObJject (); 
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Train tra = trainService.load(id); 


root.element ("train", tra, JsonUtil.config()); 


ServletActionContext .getResponse() .setCharacterEncoding ("utf-8"); 
Toot .write (ServletRctionContext.getResponse () .getWriter ()); 
} catch (Throwable e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 


} 


单 击 “添加 培训 ”按钮 ， 系 统 自动 进入 如 图 15-22 所 示 的 界面 。 通 过 该 界面 可 以 添加 培训 
信息 ， 包 括 培训 名 称 、 培 训 目 的 、 开 始 时 间 、 结 束 时 间 、 讲 师 、 培 训 人 员 和 培训 内 容 ， 在 该 页 
面 填写 完成 后 ， 单 击 “ 提 交 ” 按 钮 ， 调 用 以 上 action 的 add 方法 ， 进 行 添加 。 如 图 15-22 所 示 。 
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图 15-22 添加 培训 
在 本 系统 中 ， 按 如 图 15-21 所 示 ， 双 击 要 修改 的 培训 信息 所 在 的 行 ， 可 以 进入 修改 培训 界 
面 。 通 过 该 界面 可 以 对 所 选中 的 培训 的 信息 进行 修改 ， 包 括 培训 的 培训 名 称 、 培 训 目 的 、 开 始 
时 间 、 结 束 时 间 、 讲 师 、 培 训 人 员 和 培训 内 容 ， 如 图 15-23 所 示 。 


ss me Re 
车 动人 让 
二 Ng 要 ES ] dm 攻 ] 
于 间 2010-t-i6 |] i laoi0-11-16 | 
读 [3 ] 失信 员 [EE |] 
人 RPR 和 
十 容 : 
= BS 


15-23 ”修改 培训 


在 培训 列表 中 ， 通 过 可 勾 选 要 删除 的 培训 信息 列 ， 然 后 单 击 国 按钮 ， 系 统 会 提示 要 删除 的 
培训 信息 列 ， 如 图 15-24 所 示 。 


< 


[= Web 开发 学 习 实 录 . 必 
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图 15-24 ”删除 培训 信息 


15.4.6 ”薪资 管理 模块 


薪资 管理 模块 主要 包括 薪资 列表 、 添 加 薪资 、 修 改 薪资 和 删除 薪资 四 部 分 。 单 击 “ 薪 资信 
息 管理 ”和 “薪资 列表 ”按钮 可 以 看 到 培训 信息 的 表单 ， 包 括 员工 姓名 、 基 本 工资 、 食 补 、 房 
补 、 全 勤 奖 、 罚 款 、 发 放 时 间 和 总 计 等 信息 ， 如 图 15-25 所 示 。 


6 
日 
v 
o 
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Due 000000 3090000 10900 1000000 0 010-100 2300000 
Dme ic00000 10000 ‘109090 000000 DO- 2200000 
DR 0000 Woo 100090 30000 0 oOlL0s a00000 
Dre oo00%0 Woo i00090 900000 0 oo-Hi3 270p000 
Dm to00000 :00009 “i00000 300000 四 2 
口 aag om 100000 “i00090 900000 0 
Due ioo0000 ‘i000 |io9090 2000000 o 
mR 000000 190000 100000 1000000 和 
Dyre 00000 i0000 i00000 3900000 0 2010-LLls 2200000 
DR 1000000 0000 100000 000000 9200 ao0000 
DER oo0000 i00000 100090 00090 D0010 3300000 
Dme “1000000 so0% 1000%0 x000000 0 00Ar1e 2200000 
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以 上 列表 的 显示 ， 前 台 向 后 台 传递 了 action 请 求 ，Struts 2 根据 请 求 找到 与 请 求 相应 的 
action， 通 过 action 与 业务 逻辑 的 交互 ， 再 把 请 求 响应 传 到 页 面 ， 我 们 就 看 到 了 以 上 页 面 。 其 
中 的 action 也 是 继承 了 com.opensymphony.xwork2.ActionSupport 类 ， 代 码 如 下 。 


Q@SuppressWarnings ("serial") 

public class PayManager extends Actionsupport { 
private PayService payService = null; 
private Pay pay = null; 
private string starttime; 
private String stoptime; 
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public Pay getPay() { 
return pay; 

} 

public void setPay(Pay pay) { 
this.pay = pay; 

} 

public void setPayService (PayService payService) { 
this.payService = payService; 

} 

public String getStarttime() { 
return starttime; 

} 

public void setStarttime (String starttime) { 
this.starttime = starttime; 

} 

public String getstoptime() { 
return stoptime; 

} 

public void setStoptime (String stoptime) { 
this.stoptime = stoptime; 


} 

/*# 

* ”显示 员工 主 界面 
ereturn success 
区 六 


public String main(){ 
return success"7 


// 过 滤 查 询 功能 
private int rows = 10; 
private int page = 1; 


private Pay like = new Pay(); 
public Pay getLike() { 
return like; 
} 
public void setLike (PaYy like) { 
this.like = like; 
} 
public void setRows(int rows) { 
this.rows = rows; 
时 public void setPage (int page) { 
this.page = page; 
} 
public void list() { 
EP 
JSONObject root = new JSONObject (); 
PageList<Pay> list = payService.list(like, (page - 1) * rows, 
rows); 
int count = list.getRows(); 


< 
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root.put ("page", page); 
roODteput (totalr count rows + ((count % OWSs) > 0 2 1 = OW 
root.put ("records", count); 
JSONArray rows = new JSONArray(); 
for (Pay s : list) { 
rows.add(s, JsonUtil.config()); 
} 


root.put ("rows", rows); 


ServletActionContext.getResponse() .setCharacterEncoding ("utf-8"); 
root.write (ServletActionContext .getResponse() .getWriter ()); 
} catch (Throwable e) { 
e.printstackTrace () 7 
} 
public String add() throws ModelException { 
payService.add (pay); 
return "success"y 
} 
public String modify() { 
try { 
payService.modify (pay); 
return "success"; 
} catch (ModelException e) { 
// TODO Auto-generated catch block 
e.printstackTrace () 7 
} 
return "error"; 
} 
// 加 载 
private int id; 
public void setIdl(int id) { 
this.id = id; 
} 
public void load() { 
Ea 
JSONObject root = new JSONObject (); 


Pay pa = payService.load(id); 
root.element ("pay", pa, JsonUtil.config()); 


ServletActionContext .getResponse () .setCharacterEncoding ("utf-8"); 
root .write (ServletActionContext .getResponse () .getWriter()); 


} catch (Throwable e) { 
// TODO Auto-generated catch block 
e.printstackTrace (); 


} 
单 击 “添加 薪资 ”按钮 ， 系 统 自动 进入 如 图 15-26 所 示 的 界面 。 通 过 该 界面 可 以 添加 薪资 
信息 ， 包 括 薪 资 的 员工 姓名 、 基 本 工资 、 食 补 、 房 补 、 全 勤 奖 、 罚 款 、 发 放 时 间 和 总 计 ， 如 


5 
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图 15-26 所 示 。 
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15-26 ”添加 薪资 


在 本 系统 中 ， 按 如 图 15-25 所 示 ， 双 击 要 修改 的 薪资 信息 所 在 的 行 ， 可 以 进入 修改 薪资 界 
面 。 通过 该 界面 可 以 对 所 选中 的 薪资 的 信息 进行 修改 , 包括 薪资 的 员工 姓名 、 基 本 工资 、 食 补 、 
房 补 、 全 勤 奖 、 罚 款 、 发 放 时 间 和 总 计 ， 如 图 15-27 所 示 。 


员工 好 名 ; ER 亚 直 工 习 1000000 
人 ih [i00000 中 [aaooag ] 
和 1000000 eb 0 
Ml; I2010-11-12 if 2200000 
(= 3 
图 15-27 ”修改 薪资 


在 薪资 列表 中 ， 通 过 醒 勾 选 要 删除 的 薪资 信息 列 ， 然 后 单 击 国 按钮 ， 系 统 会 提示 要 删除 的 
薪资 信息 列 ， 如 图 15-28 所 示 。 


15-28 ”删除 薪资 信息 


< 
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5 总 结 


人 力 资源 管理 系统 是 企业 协同 管理 平台 的 重要 组 成 部 分 , 是 提高 人 力 资源 管理 水 平 而 设计 
开发 的 企业 信息 管理 系统 。 系 统 开发 采取 Java 平台 ， 采 用 Struts 2、Spring、Hibemate(SSH) 的 


框架 ,本 系统 是 在 Struts 2 的 环境 下 着 习 


招聘 管理 、 培 训 管 理 、 奖 惩 管理 、 薪 资 管 


求 。 但 是 在 开发 过 程 中 ， 还 是 显露 出 很 
是 否 熟 练 和 系统 代码 的 实际 问题 ， 将 有 


对 系统 进行 分 析 和 讲解 的 。 具 体 分 析 设计 了 员工 管理 、 
管理 和 管理 员 管 理 六 大 模块 ， 系 统 基本 能 满足 企业 的 要 
多 的 问题 ， 如 在 开发 过 程 中 ， 对 Struts 2 监听 器 的 使 用 
待 深入 地 学 习 Struts 2 会 得 以 解决 。 


填空 题 

Struts 2-core-2.1.8.1.Jar 
struts.xml 

用 来 配置 Action 类 
ActionSupport 


选择 题 
A 


D 
B 
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填空 题 
org.apache.struts2.dispatcher.FilterDispatcher 
<include file="struts-default.xml"></include> 
namespace 

Execute() 

dispatcher 


<exception-mapping...> 


选择 是 


NA>DDUD 
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一 、 填 空 题 
(1) 使 用 JDK1.5 的 注释 来 注册 类 型 转换 器 
(2) KeyProperty students=name 


(3) conversionError 
(4) xwork.default.invalid.fieldvalue 


二 、 选 择 题 
(DB 
(2)A 
(3 © 


一 、 填 空 题 

(1) 本 地 化 

(2) 国际 化 

(3) 占 位 符 

(4) language 

(5) RegisterAction 
(6) ActionContext.getContext() .setLocale(Locale locale) 
二 、 选 择 题 

() A 

4 

各 证 


一 、 填 空 

(1) 拦截 器 名 

(2) <interceptor-ref name="logger"/><interceptor-ref name="security"/> 
(3) intercept 

(4) dolIntercept 


md >> 


priority 


、 选 择 题 


外 产 产 口 


、 填 空 题 


在 validate() 方 法 中 进行 校 验 
13 

Validator 
Address-cardid-validation.xml 


、 选 择 题 


司 - 已- 时 血 


、 填 空 题 


根 对 象 (Root Object) 
数值 常量 
用 于 判断 一 个 值 是 否 在 集合 中 


附录 “参考 答案 


一 


< 一 


Seputs 2 Web 开发 学 习 实录 .入 


、 填 空 题 


(1) 控制 标签 

(2) Java.util.Comparator 
(3) ValueStack 栈 顶 
(4) scope 

(5) xhtml 


、 选 择 题 


| 


一 
© 
二 
> 


(10) A 
(11) C 


、 填 空 
commons-fileupload 
FileUploadInterceptor 
image/gif,image/jpeg,image/png 
Java.util.List 


inputName 


、 选 择 题 


口上 加 
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、 填 空 题 


Token 
TokenSessionStoreInterceptor 
token 

tokenSession 


delaySleepInterval 


、 选 择 题 


A 
C 
B 


、 填 空 题 


环绕 通知 
HQL 
Cascade 
Hibernate 
Spring 


、 选 择 题 


Ls 
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、 填 空 题 


chart 
DefaultCategoryDataset 


TimeSeriesCollection 


< 


< 


(1) 
CO) 
(3) 
(9 


、 选 择 题 


C 
A 
C 
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、 填 空 题 


uk.ltd.getahead.dwr.DWRServlet 

值 的 有 序列 表 

字符 串 

将 指定 的 事件 处 理 函 数 绑 定 到 事件 上 ， 也 可 以 绑 定 到 某 个 函数 上 ， 在 被 绑 定 的 函数 执 


行 后 ， 指 定 的 函数 将 会 被 触发 执行 。 


(1D) 
2) 
(3) 
(9 
(5) 
(6) 
(7) 


选择 题 
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